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WELCOME 
to The MagP1 111 


he story of Raspberry Pi Zero is intertwined with The 
MagPi magazine. Zero was first introduced to the world in 
The MagPi magazine issue #40. This fantastic single-board 
computer is the entry point for many of our readers. 
We’re impossibly proud to introduce Raspberry Pi Zero 2 W. 











Lucy 
Thanks to a clever design technique, it packs a faster quad-core Hattersley 
CPU into the same tiny footprint. You can use Zero 2 in your Lucy is editor of 
‘ ‘ The MagPi and it’s 
current project (just swap out a Zero for a Zero 2 and get an mortiello tie 
instant speed boost), and Zero 2 is compatible with the vast array ea eae 
of kits and current home builds. De eno naan 


magpi.cc 


Our Zero 2 feature (page 34) brings you all the information on 
this exciting new computer. And every subscriber to The MagPi in 
print will be getting a free Zero 2 in the post. We take great care 
of our subscribers and routinely hand out free gifts, from the 
original Raspberry Pi Zero to Google AIY Voice Kits, Raspberry Pi 
OS installation CDs and cooling stands, and now, Zero 2. 

It is worth subscribing to The MagPi. All new subscribers 
will also get a Raspberry 
Pi Zero 2 W (see page 32). 
On a personal note, a big 
thank-you to everybody who 
subscribes to The MagP1. You 
keep this magazine alive. 


BERS! | 





Lucy Hattersley Editor 
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Automatic Guitar Tuner Community Jams 


DISCLAIMER: Some of the tools and techniques shown in The MagPi magazine are dangerous unless used with skill, experience, and appropriate personal protection equipment. While 
we attempt to guide the reader, ultimately you are responsible for your own safety and understanding the limits of yourself and your equipment. Children should be supervised. Raspberry 
Pi (Trading) Ltd does not accept responsibility for any injuries, damage to equipment, or costs incurred from projects, tutorials or suggestions in The MagPi magazine. Laws and regulations 
covering many of the topics in The MagPi magazine are different between countries, and are always subject to change. You are responsible for understanding the requirements in your 
jurisdiction and ensuring that you comply with them. Some manufacturers place limits on the use of their hardware which some projects or suggestions in The MagPi magazine may go 
beyond. It is your responsibility to understand the manufacturer's limits. 





magpi.cc 05 


SE Magri | CONTENTS 


=. ee 


46 Sensory world — part 1 

50 Build astream deck 

54 Retro MIDI on Raspberry Pi 

60 Ultimate home server — part 4 
64 Write your own game emulator 


The Big Feature 







RISC OS Pi 


pocren SOF SOAs fl Doce Poe teeers Poiepies Funciomn Coepie =/B t 
fe |=] it | . 
SC eal Flere alte als ak 
it + IF t ol 











uae POeceanth P peter Mat saeee Chace bepcion eecions 
- | Re a) a | {4c 
~ IE fllgr LT 
a. 1 a ce 
irae beet ie re hy 
ee ea |e T 
af Lille i 4 
Si) ler el ae 
ts aoe q 









| 
4 Raspberry Pi operating systems 





80 TonyPi 
82 10 amazing Pi Bakery projects 


84 Learn circuit design 


a ee 


86 Akkie interview 
88 This Month in Raspberry Pi 





06 | magpi.cc 





Build a stream deck 





WAVESHARE E-INK 


DISPLAY PHAT 
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Raspberry P1 
Build HAT announce 


Discover the new collaboration between LEGO® 
Education and Raspberry Pi. By Lucy Hattersley 


collaborating on a new product: the 
Raspberry Pi Build HAT. 

The Build HAT is designed to combine the 
power of Raspberry Pi with the LEGO Maker Plate 
included with the LEGO Education SPIKE™ Prime 
expansion set. 

Tom Hall, General Manager at LEGO Education, 
said: “Combining SPIKE Prime with Raspberry Pi 
will inspire students to explore more advanced 
creations and continue to nurture their interest 
in STEAM learning. This brings in even more 
high ceiling learning opportunities that tap 


y aspberry Pi and LEGO® have been 





Raspberry Pi Build HAT 
provides four LEGO sockets 
and a5.5mm barrel plug 

to power and control LEGO 
motors and sensors 


into the maker space and encourage students to is included in the latest LEGO Education SPIKE 
combine different products. The Raspberry Pi Prime portfolio (version 45681, £362 / $340; 
Build HAT will be available through Raspberry Pi’s magpi.cc/spikeprime). With the Build HAT 
authorised reseller network.” attached, Raspberry Pi can control up to four 
LEGO motors and/or sensors using Python code. 
Brick building 
V Buildaremote The Build HAT is compatible with the most ‘ok ; 
ee recent generation of LEGO Technic™ motors, @ Combinin U SPIKE Prime 
and LEGO and sensors. An optional extra, the Maker Plate, 


with Raspberry Pi will 
Inspire students @ 


The Build HAT itself costs $25 and a compatible 
48W (8V DC, 6A) power supply is sold alongside 
for S15. With the power supply attached, the 
Build HAT powers both Raspberry Pi and LEGO 
motors and sensors. 

Build HAT is the second Raspberry Pi 
product to feature the RP2040 microcontroller 
designed by Raspberry Pi and first introduced with 
Raspberry Pi Pico. 

See magpi.cc/buildhat for more information. 
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The kit comprises 
a Raspberry Pi 
400 Desktop kit 
and monitor 





Leaving a legacy 


IT veteran Gerry Fillery legves a donation to help the next generation of coders 


hile Raspberry Pi was initially 
W developed for young people, folks of 

all ages have picked up our favourite 
microcomputer for fun and practical projects. 
Gerry Fillery was one of those people. 

Having retired from his career in IT ten years 
ago, Gerry took an interest in Raspberry Pi, and 
had projects set up around his house. “Each time 
I would visit him he seemed to have acquired 
more bits and pieces, he was quite an enthusiast,” 
recalls his friend. 

Gerry’s interest in Raspberry Pi was so great that 
he decided to leave a donation to the Raspberry Pi 
Foundation in his will, and is the first person to 
have done so. His generosity will help support the 
computer science and maker education of millions 
of young people all over the world. 


Connecting people 

A part of this donation has gone towards 
distributing free Raspberry Pi Desktop kits to 
those who do not have a computer at home as 
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M His generosity will help 
Support the computer 
science and maker 
education of millions of 
young people 


part of the Stay Connected to School initiative, 
allowing them to stay connected to learning 
whilst schooling is disrupted. 

“Gerry is our first ever legacy donor,” said 
Teresa Hicks, Director of Strategic Partnerships 
at the Raspberry Pi Foundation. “We are 
incredibly grateful for his generous gift. His 
legacy lives on through helping us to bring maker 
education to young people all over the world”. 


Vocal vocation 
Gerry grew up in Blackheath, London. Asa 
youngster, he also had links to Fairlop and Seven 


MagPi 





_ _ ae 






The donation was able to 
fund several kits for young 
people. Partners like the 
East London Business 
Alliance (ELBA) have 
supported kit distribution 


Ideal for family 
learning + clubs! 


Ideal G/T and 









/. The kit comprises 
a Raspberry Pi 
400 Desktop kit 
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If you want to follow in Gerry's footsteps : 

and help bring computers and computing © Clear and easy-to-read , s 
education to young people around the - - > a= 
world, you can donate to the Raspberry Pi large format (10 X ) ) N 8 
SY D 

Foundation at rpf.io/donate. \ 2 
@ Raspberry Pi based . ea ae z 

& 


projects + mac/PC and 
Chromebook compatible 


Kings, and was educated at Edinburgh University 
where he studied as a Statistician and Actuary. 

He worked as a techie throughout his career, 
preferring a technological challenge. 

He would often talk of voice applications in 
tech, a field he was very familiar with: he worked 
on early bank telephone automation systems. 

He lived for the last 20 years of his days in 
Frimley Green, Surrey. Thank you, Gerry, for all 
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SPY-DER 
Robot 


A multi-legged surveillance robot combines Al and 
Raspberry Pi, Rosie Hattersley |egrns some spidey-sense 


of spiders may find themselves a little 
uncomfortable at the design of the latest AI 
robot created by the Sparklers, a group of computer 
science engineers in India. Not only does the robot 
specialise in watching its object’s every move, 
but it has multiple legs and the ability to move in 
unexpected ways. 
Team leader Arijit Das explains that SPY-DER 
is so-named because of its ability to walk like an 
arachnopod — much to the consternation of some 


T hose of us with an aversion to the company 





Arijit Das 





Indian computer 
science engineer 


Arijit runs a group observers. The robot’s main purpose is for live video 
of anit surveillance, streaming footage that can be viewed 
ae an ° remotely via a dedicated web browser. SPY-DER 
focuses on making can be controlled in two ways, either through voice 
Al- and robotic- commands or from the web interface. Riffing on one 
pase: pidlec’s of the favourite items of prey for real-life spiders, 
such as a Sudoku- . ‘ ; jf 

solving buddy. Arijit uses ‘bumblebee’ as the robot’s wake word, 


prompting its LED eyes to light up. 

“Whenever I call it by its name, it starts listening 
to me and then, based on my voice comman4d, it 
will act,” he clarifies. These commands cover both 
speech recognition and ‘intent detection’. “I can give 
SPY-DER the same command in different ways, i.e. 
‘Wave your hands’ or ‘Say hello’. Both commands 
make it wave its legs,” says Arijit. The online 
control panel, meanwhile, lets the user control all of 
SPY-DER’s actions. If such movements don’t make 
you tense up, you can take a look at SPY-DER in 
action at magpi.cc/spyderyt. 


magpi.cc/spyder 


Y=] aV(om gale) Ke) e-m-l com Uisi-10 BKeere)alige)| 
the legs, which wave majestically, 
just like a friendly spider 


Evolutionary process 
The first version of SPY-DER was an Arduino Nano- 
based device, controllable via an Android smartphone 
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Raspberry Pi Zero W enables the web 
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— . . > SPY-DER can 
= | be built over the 
course of a week 


Arijit's version of 


DYoYahmot-W-1e-laanl-roMm lUimolamar-t-lalale the chassis is here: 


the wake word, the SPY-DER magpuce? 
(ge) oXe) =m m= DA-\V,-\-M le] al mele) spyderprint 





He built his own 
after seeing how 
much commercial 
robots cost 


Reactions from 
friends and his 
pet rabbit have 
been extreme... 


Extreme delight or 
extreme fright! 
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> SPY-DER mimics its near 
namesake but operates 
on just four legs 
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V_ SPY-DER's eyes light up 
ominously in response 
to the wake word 


tm 
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A Arijit 3D-printed the 
parts for the spider 
robot's chassis 


or web browser, but lacking the voice recognition 
aspect Arijit was keen to add. “Obviously I needed a 
small computer here,” he comments. Several of his 
previous projects, including the Sudoku-solving 
robot we featured in The MagPi #98 (magpi.cc/98), 
were based around Raspberry Pi. Size constraints 
led Arijit to choose Raspberry Pi Zero W this time. 
Wireless connectivity and the ability to connect 

to a Raspberry Pi Camera Module were also 

critical features. 

The limited RAM provision of Raspberry Zero W 
presents a challenge for Arijit’s hope of eventually 
implementing a local speech and intent recognition 
system from scratch. The speech recognition 
system would need to be highly optimised, 
otherwise it will take a lot of time to recognise the 
speech, he acknowledges. For now, SPY-DER uses 
an amended version of Picovoice (picovoice.ai) 
speech recognition, but in time Arijit also aims to 
add image processing and Al-based features, such 
as object tracking and face recognition. 


Building it 

Rather than designing SPY-DER’s body from 
scratch, and having recently got his first 3D 
printer, Arijit adapted an existing spider robot 
chassis (magpi.cc/spiderbot), changing its 
dimensions to accommodate Raspberry Pi Zero W, 
microphone, and the Camera Module. He tweaked 
the spider robot’s Arduino code, but wrote the 
Python code for Raspberry Pi to be able to control 
SPY-DER. The web controls use a Flask framework 
with a web page coded in HTML, CSS, and jQuery. 
“For the live video streaming, I used RPi-Cam- 
Web-Interface (magpi.cc/rpicamweb), due to 

the fact that the latency is very low here,” Arijit 
explains. Helpfully, he provides diagrams and code 
at magpi.cc/spyder. {I 
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I spy... spy spiders 


To build your own spider robot, first follow Arijit’s 
online instruction video: magpi.cc/spyderbuild. 
The second YouTube video explains how to 
incorporate Raspberry Pi in order to make use of Al 
features: magpi.cc/spyderai. 


RGA 4 





01 Download and 3D-print the spider body 

parts (magpi.cc/spyderprint). Then attach 
the servo motors for the legs, and assemble the 
rest of the body. 


4 









02 Attach battery and charging cables, Arduino 

and Arduino IO shield, and install the Arduino 
code before inserting Raspberry Pi Zero W, USB 
microphone, and Camera Module. 


Download the project code from Arijit's GitHub 
03 } | 
repository (magpi.cc/spyder) along with 
Picovoice, amending the code as indicated. For video 
streaming, you'll also need to install the RPi-Cam- 
Web-Interface. 
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Automatic 
Guitar Tuner 


A Pico-powered automatic tool to tune your guitar? 
Nicola King Is inspired to start strumming 


Guyrandy 
Jean-Gilles 





Guyrandy is an 
engineer and maker 
from the US east 
coast. He got his 
bioengineering 
degree from 

the University of 
Pennsylvania, and 
currently works 

in the medical 
device industry. 


magpi.cc/ 
tunergitlab 





an ultra-cool guitar if you don’t have 

the means to make sure it stays in tune, 
especially if you’re pursuing a Springsteen-esque 
form of brilliance on the fretboard. 

Guyrandy Jean-Gilles is a musical maker who 
took Raspberry Pi Pico and created something 
rather special. “The goal of the project was to make 
a low-cost, automatic guitar tuner,” he tells us. 
“Td been meaning to do a project with Pico and 
there are few development boards as cheap and 
well-documented.” 


et’s face it, there’s no point in having 


Pico power 

Guyrandy developed his idea over a two-month 
period, and the result is a very useful device. The 
euitarist chooses whichever string they want to 
tune and then places the tuner on the appropriate 
tuning peg. A button on the automatic tuner is 
held down by the user which then activates the 
microphone, and the tuner begins to determine the 


M|'d been meaning to do a project with Pico 
gnd there are few development boards as 
cheap and well-documented & 





@ «eal 


A Guyrandy demonstrates his automatic 
guitar tuner, here using it to turn the 
peg for the top E string 
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pitch of the tone coming from the plucked string. 
It then twists/adjusts the peg as necessary to 
ensure accurate tuning for sweet sounds. 

Guyrandy tells us that Pico is the brains of the 
entire tuner: “It samples an electret microphone 
at 4096 samples per second, computes an FFT 
(fast Fourier transform), finds the strongest 
magnitude frequency in the audio, then turns a 
DC motor clockwise or counter-clockwise until 
the target frequency and the strongest frequency 
in the audio match.” 


Change your tune 

As with all electronic makes, this was a learning 
experience with a few bridges to be crossed, and 
the trickiest part of the build was determining a 
euitar string’s pitch from audio. “There’s a lot of 
academic research in the area that I wasn’t aware 
of before starting the project,” says Guyrandy. 
“This version found the strongest magnitude in a 
fast Fourier transform, and assumed that was the 
fundamental frequency.” 

In terms of accuracy, he found a few blips that he 
had to even out. “The tuner’s frequency detection 
is repeatable but inaccurate. It will mistakenly 
think harmonics are the fundamental frequency 
for almost all cases. I had to hard-code harmonic 
frequencies into the firmware to make the tuner 
work appropriately,” he explains. 

That said, the tunings are reliably inaccurate so 
they can be used to correctly tune a guitar. “For 
example, the low E string is 82.4Hz in standard 
tuning, but the project repeatable thinks it’s 250 Hz. 
Currently alternate tunings aren’t possible, but with 
a firmware change, drop tunings can be achieved.” 

Guyrandy has had plenty of suggestions from 
other makers in terms of potential improvements, 
including adding a vibration sensor so the tuner 
can be used in a noisy setting, and also “to make 
a tuner that fits over all the tuning heads of the 
euitar and tunes all the strings simultaneously. 


ai al-m = De) mual-8-y-1(-ceak-le jaa lale| 
lights up; two RGB LEDs below 
indicate the current status — 
green for correctly tuned 


While this is cool, I’m not sure how I’d separate 
two different fundamental frequencies from one 
audio signal.” 

He is currently working on a second 
version of the tuner and will be trying the YIN 
(magpi.cc/yin) algorithm to detect frequency, as 
well as incorporating some piezo-electric sensors 


to pick up vibrations, along with a stronger motor. 


If you’d like to have a go at making your own 
version of the tuner, Guyrandy has generously 
made his code open-source, and information on 
exactly what you need in order to build it can be 
found on his GitLab page (magpi.cc/tunergitlab). 
Why not dust off that old guitar and get making? 


m(o)Ke Mdal-m ole ableleiave)ame)al re) e) 
fo} tatoo (-\V (X= mKom-jr-lamlcik-vallarep 
then pluck the string you've 
Y=) (=You K=Ye BV// ial Wal=m gelt-l ava dalele) 
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reaches the correct pitch 
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Guyrandy was 
inspired by 

the Roadie 3 
guitar tuner: 
magpi.cc/roadie3 


To make your 
own, you'll need 

a Pico, Adafruit 
PowerBoost 1000... 


..folus tactile 
buttons, mini metal 
gear motor, and 
some LEDs 


In 2017, Guyrandy 
snappily decorated 
his graduation cap 
and gown... 


with the official 
7-inch display and 
a Raspberry Pi 3: 
magpi.cc/gradcap 


Guyrandy designed 
a slick-looking 
case for the tuner 
in CAD software 
and 3D-printed the 
parts for it 
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Electronic nose 


Sniffing out your surroundings with this next step in sensor technology, 
Rob Zwetsloot asks g Raspberry Pi to detect cheese or petrol 











ight sensors, temperature sensors, humidity A 98 percent classification accuracy was achieved in 
sensors, noises sensors (i.e. microphones) the testing process.” 
are all fairly common, however gas sensors 
are not something you see everyday. Using them Smell test 
specifically to ‘smell’ your surroundings is even rarer. With only four types of gas sensors, extensive 
Luis Rodriguez Mendoza is the creator of one of these testing and training of the model was required. 
rare projects. “A training data set was created by taking 
Luis Rodri After learning about the different and weird things measurements of air, beer, and coffee 
eae dogs have been trained to identify by smell at the independently.” Luis explains. “Each sample was 
Mendoza 
airport, Luis asked the question of whether he could do taken, on average, for 15 minutes at one second 
Meson something similar with low-cost gas sensors. intervals, producing over 900 sample readings per 
Engineering “The purpose of the project is to show that low-cost test and the data was exported into CSV files. For 
Master's student sensors can be reliable in detecting odours and that classification purposes, an additional column was 
- on ee they can possibly be used in clinical settings.” Luis tells | manually added to label the sample (i.e., coffee, 
eascioncie abour us. “Testing was done using samples of beer and brewed _ beer, air). The three datasets were imported and 
health and science, coffee. A K-Nearest Neighbours (KNN) algorithm was combined in MATLAB. This data was used to create 
ancepPucations used in MATLAB to create a classification model that a k-nearest neighbour model, k was selected to 
of wearable : ; ; : 
technology. was used to predict the aromas of beer and coffee, and be 5, this was determined by trial and error. A 
was validated using a 10-fold cross validation (k-fold).... 10-fold cross-validation was used to validate the 
9 Principal Component Analysis 


Component 2 


> The principal 
component analysis 
gives a more 
accurate reading of 
What data is being 
collected 
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Using the Explorer HAT 
makes connecting all 


the sensors very easy The sensors 


detect methane, 
hydrogen, carbon 
monoxide, and 
alcohol molecules 








PAAVcla(=1AAe) me f= B=) aie) 6 
detect different types 
of scents 





o> 
7. ‘ 





The news article 
that inspired it 
was about dogs in 
Finnish airports 


3 
= 


—AINNFIH19 


Luis likes to 
develop wearables 
that analyze 
biomechanics... 


. like his 
accelerometer 
that determines 
body position 


The whole setup is while cycling 
loko) /{=1a=16 exe) gale] K=1K=1 AV, 


by Raspberry Pi Methane Is part of 


the coffee aroma, 
however alcohols 


can also be part 
of it 
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Sniffing electronically 


Gas Sensor Reading 


The sensors are calibrated when it turns on - 
this is done by having the Python script run on 
start up, and holding the sensors away from anything 
you'd like to whiff. Once the sensors are calibrated to 
neutral, a sensor reading will be displayed. 





A Professional electronic 


model, and a Principal Component Analysis (PCA) POOR EMS amet an silico nds ibonen te lnediel iis 
was used as an exploratory technique to verify the and engineering sectors a) 
‘io and can cost thousands woe 
model and the results, similar to the work shown | 2st i eaten) —— en |} 
in past research. ee U ieee ae 
“A test dataset was gathered by taking 17 new s | 
samples of two-minute readings at one second : a | - 
intervals to assess the classification model. Each : Pe 
sample was independent of each other (only air, 6 oes eae 
beer, or coffee was measured at a time), and they | 
were manually labelled accordingly, resulting in 
over 2500 measurements. This data was imported, 
‘ soo noo a ae 100 


combined, and randomly rearranged in MATLAB. 
Using the classification model created from the 
training dataset, the testing data was classified and 
the results from the classification model represent 
97.7% accuracy.” 


Placing the e-nose on the sample will begin 
a reading using the gas sensors, which will 
be automatically logged in a CSV file for you to look 
at later. 


M| guickly realized how easy, 
efficient, and capable 
Raspberry Pi boards dre 


A near 98% accuracy is extremely impressive 
for the three test subjects, and it’s all done ona 
Raspberry Pi 3. 

“Raspberry Pi was introduced to me in the fall 
of 2020 during one of my university courses,” Luis 
said. “I quickly realized how easy, efficient, and 
capable Raspberry Pi boards are.” 

It’s a cool, working concept, so we hope to see 
more like it in the future. Hl 





The CSV file can be processed using MATLAB, 
and there are a couple of post-process scripts 
that Luis have created to output at confusion matrix 

with classifications, along with PCA and the raw data. 
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Pico Light Arcade 


This inexpensive build was created in a single evening and 


it's set to provide hours of fun, as David Crookes discovers 





Thomas Roth 





Thomas Roth is an IT 
security researcher 
who lives in Germany 
and creates videos 
about hardware 
hacking and 
reverse-engineering. 


magpi.cc/ 
picolight 





ee 


unless you’ve grabbed hold of a soft rubber 
mallet and exerted huge amounts of 
energy on a Satisfying game of Whac-A-Mole. 
Known as Mogura Taiji in Japan, where the game 
originated, it relies on speedy reactions to hit as 
many small plastic moles as possible —- and when 
Thomas Roth had a go, he decided he had to create 
a version for himself. 
“Tt was a small arcade and my friend and I had 
so much fun with a game like this, I just knew I 
wanted to have one for our parties,” he says. In his 
case, the ‘moles’ he was bashing were a set of LED 
lights and Thomas reckoned it would be relatively 
easy to replicate. “I spent zero time planning 
it,” he continues. “I came back from the arcade, 


[ssi to a seaside arcade is rarely complete 





A As if to prove German has a word for 
everything, Thomas refers to this messy array 
of wires surrounding Raspberry Pi Pico as 
“kabelsalat” - or cable salad in English 
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ordered the arcade buttons and, once they arrived, 
I drilled 20 holes into a board I had lying around.” 
The holes were arranged so that each player 
would have one button immediately in front of 
them, followed by a row of three and then a further 
five — making for nine each. Two buttons were 
placed in the centre: one to start the game and 
the other to select a playing mode. “I screwed in 
the buttons and wired them up in a 3x7 matrix,” 
Thomas says. “There was no soldering involved.” 


Keeping score 

Once done, Thomas began to program the 

game and he reckoned a Raspberry Pi Pico 
microcontroller would be more than capable of 
running it. “I really like the simplicity of Raspberry 
Pi Pico,” he says. “Firmware updates are drag- 
and-drop, it’s super-easy to code for, it’s really 
cheap, and it boots up immediately, too.” 

At first, he flexed his C programming skills to 
code what he describes as “a high-speed Whac-A- 
Mole” with the goal being to hit any buttons that 
light up as fast as possible. “Whoever manages 
to press the most buttons in 45 seconds wins,” 
he smiles, adding that he then wanted a way of 
displaying the score. 

“T didn’t have a nice display lying around so I 
built a Web Serial-based website that also shows a 
scoreboard,” he says. “This is completely optional, 
though, and the table will run happily without it.” 


Mind games 

Once the rules of Whac-A-Mole were established 
and coded, he then moved on to create a second 
mode: replicating a game of Simon. “The table 
shows a sequence and both players have to 
remember and repeat it. The sequence gets longer 


'SxcYou aly o)k=\\(-1 au at-\-mal lato molelace)alomne) 
press. These two in the centre 

FeV Ke)V me l= lgal=mkom-it-lam-laleMellix-a-1als 
fe felaat= manele (=m Ko ol-m el t-\V{=16 


The table looks great with its retro-style 
Wi (eo (slo Me l=lgal-m<j N(ol (=) p-emene) lol Ula-le mel | gellar 
iulacelelateliavemaar-molelace)alowr- lace m- Me) t=(el¢ 

irc) elomilalciam-lcelelacemsarom-rele (=r 


lm There was no soldering 
involved @ 


and longer, and whoever first presses a wrong 
button loses.” 

He’s not ready to stop there, though. “I would 
love to have more game modes and I'd also love to 
see someone hook up a seven-segment display to 
show the score,” he reveals. “I’m also designing a 
PCB to make the underside a bit cleaner — as it is, 
there are 20 buttons with four wires to each and it 
looks messy.” 

Even so, it also looks like a heap of fun. “It 
certainly is, and it should be a great project for 
anyone to do with kids,” Thomas adds. “In fact, 
two friends of mine have already decided to build 


their own with their children, but adults will have a 


fantastic time with it too.” 


PROJECT SHOWCASE | Mag?i 


Sial-1c>m-le-m-1ee-|cor-(e(- mole lacelal-mlamce)ra\l 

but Thomas says they're 3.3 V each and 
fotela <=ladatelamal=xe Mal (ome Cole maal(e|almycclal mine) 
change the resistor,” he suggests 








> The build and 
code took three to 
four hours 


> It cost roughly $45 
to create 


> There are two 
game modes 


>» The scoreboard 
uses the Web 
Serial API 


> You can choose 


your own 
button layout 


Warning! 





This project requires use 
of a drill. Be careful when 
using electric tools. 


magpi.cc/drillsafety 


@A laptop is being used 
to display the score, 
but It's only acting 
as a screen. Thomas 
would prefer to use 
a seven-segment 
display, but didn't 
have any to hand 
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A Raspberry Pi sends out all the 


Neh takoel eam ave mie) info to the various tablets 


the tablet screen 
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follow along 





Bob Steele 


A retired software 
developer currently 
living in Portland. He 
writes software for 
the community jams 
and plays bass guitar 
with them. 


communityjams.org 


» Who needs books of 


music when it gets 
sent to your tablet? 





ANS ©) 0) (=Xoi Ke) mV {<3 
experimented 
with, but it was too 
‘o}dtelalmiamtal=m ex- la 


Bringing the jam sessions outside thanks to ag Raspberry P! broadcasting 
notes and lyrics. Rob Zwetsloot grabs a seat and listens 


hile reading The MagPi, you might think 

that a reference to a Jam would be for 

a Raspberry Jam. In this case you’d be 
wrong, it’s about a community of musicians that 
like to play together. 

Over the course of last year, the way they play 

together had to change. Mainly, they had to move 
outside and that caused some problems. 
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“Community Jams (communityjams.org) 
couldn’t play music indoors using our 
web-based chords and lyrics application 
(magpi.cc/musicapp),” says Bob Steele, a retired 
programmer and current Community Jams member. 
“Outdoors, I put the app on a Raspberry Pi so we 
didn’t need an internet connection. Raspberry Pi 
had a web server to deliver the application from 
Apache. Unfortunately, the projector was too weak 
in bright sunlight and was always subject to having 
its screen blow over in the wind. I figured out that if 
the app was delivered from [Apache] Tomcat, I could 
create a web socket protocol that would share the 
current song and position to many tablets. So now 
the musicians are outside, masked, separated bya 
good distance, and all able to share the same display 
on their personal tablets.” 


Early adopter 

Although Bob has been programming and working 
with computers for several decades, he’s mainly 
worked with software projects: “In the early 1980s 


Avery simple setup, 
which allows for the 
group to play together 


I designed or help design a number of internal 
hardware projects for the video industry. 

“T heard about [Raspberry Pi] from the internet 
in the early days,” he says. “I’ve ended up buying 


The musicians are happy 
that: 1} they get to play 
music in the park and 2) 
they know next to nothing 
about how it works 


at least one of every model. Don’t know why, but 
they are good platforms for small projects. I first 
used UNIX in 1975 and my personal machine has 
been Linux for many decades ... so Raspberry Pi 
seems like home. In fact, most of them never get 
connected to a keyboard, mouse, or display. SSH or 
VNC is all I usually need.” 


Can't beat it 

It’s a simple project with a simple goal — to display 
music for musicians, and it works well in that 
regard according to Bob: “The musicians are happy 
that: 1) they get to play music in the park and 2) 
they know next to nothing about how it works.” 





MagPi 


Bob used to work 
in Silicon Valley 


Jam sessions can 
be traced back to 
1920S Jazz 


Bassist Bob also 
has a bass guitar 
learning app on 
his site 


Community 

Jams spun off 
from Portland 
Casual Jams... 


which was created 
14 years ago and 
has 3700 members 


a : , The web app that Bob 
The whole setup is just a Raspberry Pi 3 with created aeecenon 
Bob’s software, an access point to connect toa several screen sizes 


local wireless LAN, and a battery to run it. 

“T should have installed DNS instead of the fixed 
IP address,” Bob ruminates. “The fixed IP address 
helps when Raspberry Pi is not in the park. It gets 
plugged in, attaches to the local WiFi, and updates 
itself using crontab jobs.” 

While its humble use as a way to get some 
friends to play music together is great, we feel 
the technology is simple yet powerful enough to 
be expanded to larger groups. Check out Bob’s 
website, bsteele.com, for more about Community 
Jams and his other projects. 
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Pico Robot 









The smartphone's accelerometer not 
only picks up left and right movement, 
but allows MohammadRezcza to tilt 
forward and back to control the direction 


Rather than use a standard controller, this robot is steered using 
gn Android phone's accelerometer, David Crookes takes a look 





MohammadReza 
Sharifi 


MohammadReza 

is a self-described 
geek, gamer, writer, 
cinema lover, 
YouTuber, and 
engineer. He lives in 
Khuzestan, Iran. 


magpi.cc 


obotics projects have long been popular 
among the Raspberry Pi community, but 
MohammadReza Sharifi’s outstanding 
contribution definitely has a touch of va va 
voom about it. Powered by a Raspberry Pi Pico, 
his four-wheel drive car is controlled using the 
accelerometer in an Android smartphone. “The idea 
suddenly came to my mind,” he tells us, “and it 
took me about three hours to build and program.” 

That itself is impressive, particularly given the 
work needed to get things moving. It all began two 
months ago when MohammadReza was browsing 
Instagram. “I saw a promotional video about a toy 
in which a coloured ball was being controlled by 
mobile gestures,” he says. “I thought to myself 
that controlling a robot using mobile gestures 
could also be an interesting project.” 

From that point on, he quickly looked to gather 
the equipment needed. To start with, he bought 
an inexpensive plastic robot car chassis kit which 
came complete with four yellow wheels and four 
DC gear motors. He then added a L298 motor driver 
and an HCo5 Bluetooth module. 


Speeding ahead 

“T decided to connect these to a Raspberry Pi Pico 
microcontroller,” he says. “I’d seen that a small 
number of robotics projects had been implemented 


Raspberry Pi Pico Robot 


using Raspberry Pi Pico, and 1 wanted to experience 

the challenge of working with the microcontroller.” 
To ensure that the robot could make use of 

a smartphone’s accelerometer, MohammadReza 

needed to develop a custom app. He did 

so using the MIT App Inventor platform 

(appinventor.mit.edu) — a blocks-based visual 

programming environment that makes it relatively 

easy to create software for mobiles. 


The biggest challenge was 
definitely butlding the 
mobile app 


“The main advantage of this platform is that 
you don’t have to deal with coding challenges 
because it lets you focus more on the main 
concept of a project,” MohammadReza explains. 
That said, it wasn’t totally straightforward, as you 
can perhaps imagine. 


Twists and turns 

The idea was to create an app that would send data 
from the accelerometer to Raspberry Pi Pico in 
real-time via a Bluetooth connection. That way, 
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When the smartphone is 
titled, the app on the device — Tilting a 










sends the movement details smartphone steers 
to Pico via Bluetooth the robot 
A bespoke Android 
controller app 


was developed 
The chassis was bought 
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A Python app 
was created for 
Raspberry Pi Pico 
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The project cost 
MohammadReza could tilt his smartphone left, for about £40 to make 
instance, and send information telling the robot to 
move left. 

This is what took up much of the development 
time. “The biggest challenge was definitely 
building the mobile app,” he reveals. “It needed 
to identify the co-ordinate axes and identify the 
position of the accelerometer sensor in the mobile. 
It also needed to perform trial and error to find the 
amount of angular acceleration and the magnitude 
of acceleration.” 

Eventually, however, it began to work near- 
flawlessly. He’s now considering creating a version 
for iPhone, but although the MIT App Inventor web 
application is free, open-source, and allows apps to 
be made for iOS and Android, he’s decided to use a 
different system for the Apple device. 

“T will create an iOS app for the robot using 
Kivy,” he says, referring to the free and open- 
source Python framework and relishing a fresh 
challenge. His priority first and foremost this time 
around, he adds, was just getting it to work with 
his Xiaomi Redmi Note 9 Pro Android smartphone 
and he’s more than happy to see it going down well 
with other makers online. “It makes me proud that 
people are interested in my project,” he beams. 


See it in action 
at: magpi.cc/ 
picorobotyt 
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Oasis-grow 





Mike Lee and 
Aviel Stein 


Oasis-X Co- 
founders Mike 
and Aviel met at 

a maker event 

in Pennsylvania 
where self- 
taught coder and 
entrepreneur Mike 
was showing off 
several Raspberry 
Pi projects. 


oasis-x.io 





> The temperature- 


controlled incubation 
tent has sensors to 
monitor humidity, 


airflow, and light levels 
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Growing fruit and vegetables can be so frustrating, but a 
Raspberry Pi-based smart agriculture project helps take the 
uncertainty out of cultivation. Rosie Hattersley reports 


organisms don’t respond in linear ways,” 


4d p lants, mushrooms, and other cultivated 


even when provided with supposedly 
‘ideal’ growing conditions, much to the 
frustration and disappointment of those keen 
to cultivate their own food, observes 25-year- 


old entrepreneur and technology fan Mike Lee. 


Such nonconformity “is a mindset that many 
programmers and engineers find difficult to 
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accept,” says Mike, explaining why he and his PhD 
student co-founder Aviel Stein set about improving 
the odds of a successful harvest. Their response, 
Oasis-grow, is a ‘smart agriculture engine’ 

that runs on Raspberry Pi and collects detailed 
information about whatever the user cares to grow 
in a bid for more predictable results. 

The system provides visual and sensor data, plus 
controls for heat, humidity, airflow, light, and 
watering cycles. The selling point is a system that 
“keeps your plants, mushrooms, and Petri dishes 
happy, and remotely monitors the grow space so 
you can identify and address problems before they 
get serious.” 


Make room for mushrooms 
Mike and Aviel met at the 2019 Pennsylvania 
Maker Faire where, among other projects of his 
own devising, Mike presented his first Raspberry 
Pi project: a dashboard camera with buttons and 
a remote, back-window LED screen for signalling 
other cars. “It was very cool but perhaps a bit too 
dangerous for the road (the other cars did not 
react ... well),” he admits. Nonetheless, the pair 
decided to work together, and quickly formed 
Oasis-X (magpi.cc/oasisx) having identified a 
market for a smart agriculture monitoring tool. 
Aware that DIY plant monitoring and sensor kits 
were already available, Mike and Aviel needed to be 
sure they were offering something that fulfilled the 
scalability promise it would need to be of interest 
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Sensors attached to Raspberry ee Mike has been 
Sec Maaicyetlecw-limalelaal(e (inva ie] als cultivating 
levels, soil moisture; a time- P mushrooms for 
lapse camera is also used \ two years 


Aviel has a long- 
term interest in 
permaculture 


The project 
attracted its first 
potential customers 
in August 2020 


From beta to 
manufacturing took 
Oasis-X a year 


Simplifying it 

and making 
improvements are 
of course ongoing 





Cultures could be cultivated in 
bottles or jars, or the whole box used 
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Warning! 
Electrical Safety 


Please be careful when 
working with electrical 
projects around the 
home. Especially if they 
involve mains electricity. 


magpi.cc/ 
electricalsafety 


> Time-lapse images 
can be taken of the 
contents in their Petri 
dish habitat 
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to agriculture, and merit a commercial launch. 
Mike explains it was important for Oasis-X to take 
an “open-source first approach” to developing 
agriculture technology. “Technology vendor lock- 
in is such a big issue for farmers,” he continues. 


M Oasis-xX is also keen to make the concept 
available for hobbyists and home 
Norticulturists, providing source code and 
Nardware architecture details via GitHub 
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“Our systems must collect and store lots of 
different information while communicating with 
the network and managing multiple independent 
processes, [so] a full-fledged operating system is 
close to required.” 
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Ploughing ahead 

Oasis-grow’s makers took inspiration from 
older projects, and chose Raspberry Pi because 
of its multitasking capabilities and a file system 
that they found made organising and retrieving 
complex data a much simpler task. Most of the 
hardware they use for prototyping was bought 
from the usual online retailers, with Raspberry 
Pi running Bash alongside Raspberry Pi OS and 
Python. Their web interface was created in Python 
and uses AWS (Amazon Web Services). 

“We’ve spent the last year nailing down the core 
functionality and are in the process of making it 
faster, more modular, and easier to use,” Mike 
explains. The system went through more than 20 
iterations and was developed in close consultation 
with farmers and home horticulturists. This 
process helped Mike and Aviel realise that the 
vision, sensing, and environmental helper 
modules were valuable individually as well as 


collectively. As a result, the pair are soon set to 
offer an open-source version of the GUI integrating 
machine learning, decision support, and smart 
notification prototypes. 

As an agri-business system, Oasis-grow had 
to prove its worth and has undergone successful 
long-term, large-scale field tests in farms in the 
eastern US over the past year. These ‘turn-key 
erowing systems’ have recently been distributed 
to the company’s early backers, with a Kickstarter 
campaign fundraising towards its ‘smaller helper 
modules’ currently running. However, Oasis-X 
is also keen to make the concept available for 
hobbyists and home horticulturists, providing 
source code and hardware architecture details via 
GitHub (magpi.cc/oasisgrowgit). WI 





A Impressive results 
from their initial home 
growing chambers 
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Grow your own 


Raspberry Pi 3B, a USB camera, and a power supply 
are the basis of this project. Full setup instructions 
can be found at magpi.cc/oasisgrowgit. 


T. & 


(0) \ 
Wi 


01 Download the Oasis-grow code from the 
GitHub page (an installable operating 
image is in development, take a look at the GitHub 
instructions). Set up your incubation tent, or position 
the camera to monitor it. 





02 To start data collection, turn on the 

Raspberry Pi camera, start Python, and run 
main.py. If successful, the image loader will run on 
bootup next time. 
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03 For more detailed monitoring, add a relay 
board for AC control, GPIO buttons fora 

physical interface, environmental sensors, and LED 

status displays, as per Oasis-grow’s full configuration. 
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JOIN FOR 12 MONTHS AND GETA 
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12-MONTH SUBSCRIPTION 


A full Raspberry 
Pi desktop 
computer 





Learn to code and 
build your own 
projects 


Make your own 
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Introducing 
Raspberry Pi Zero 2 W 











FEATURE | MagPi 





Introducing Raspberry Pi Zero2\W/ | magpi.cc | 35 


MagPi | FEATURE 





aspberry Pi Zero 2 W is designed to be 

instantly swappable with Raspberry Pi 

Zero in acurrent project, with an identical 
form factor and most components in the same 
place. Dig a little deeper, and there are a host of 
tweaks and improvements across the board. 


©@ SYSTEM-IN-PACKAGE 





Broadcom BCM2710A1 quad-core 
Arm Cortex-A53 (ARMv8-A) 64-bit 
@ 1GHz 


Broadcom VideoCore IV 


512MB DRAM 


802.11 b/g/n wireless LAN, Bluetooth 
4.2 (Bluetooth Low Energy, BLE) 


HAT-compatible 40-pin GPIO header, 
unpopulated 


haat 


- 
“eclacmnet: Bh 
#, 40h | =~ if , 


microSD 


Micro SDCard slot, Mini HDMI, USB 
On-The-Go, micro USB power; 
composite video and reset pins 
(via solder test points), CSI camera 
connector 


1W (idle in Raspberry Pi OS GUI); 
Max power, 3.8 W or 0.76A (32-bit 
mode); 5.5 W or 1.1A (64-bit) mode 


$15 


66 x 30.5 x 5mm form-factor 
(compatible with Raspberry Pi Zero) 
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One interesting new aspect of Raspberry Pi 
Zero 2 W is the System-in-Package approach 
@ WIRELESS LAN to the chipset design. 

T A Broadcom BC2710A1 SoC is placed on 
the substrate and 512MB of DRAM is placed 
above, with an interposer placed between the 
two (to act as a Spacer’). This enables both 
chips to connect neatly to the substrate using 
gold wire. The whole thing is placed inside a 
mould. This is the black chip you see on the 
Raspberry Pi board. 





—] Mould el 
DRAM 
| BCM2710A1 | | 


oY aed 

















The picture is a view of a3mm ~x 
2mm section of the System-in- 
Package. The black circles are 
solder balls. The thick grey lines 
are tracks on the substrate. The 
thin black lines are gold wires, and 
you can see them bonding to the 
silicon (which is transparent to the 
X-ray machine). Here, we can see 
the 0201 (50 um x 25um in size) 
capacitors inside the package. 





Here is a top-down X-ray of the 
System-in-Package that reveals 
an Easter egg! Spot the Raspberry 
Pi logo shape in the ball map. This 
is possible because, while the 
connections on the outside are 
Signals, the ones in the middle 
are ground/power and can be 
arranged into any pattern. 
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e caught up with Simon Martin, 

Principal Hardware Engineer at 

Raspberry Pi and Eben Upton, founder 
and CEO of Raspberry Pi. 

Simon: “Raspberry Pi Zero 2 W is all about how 
much power you can pack into such a tiny space. 
It’s about just how much can we get from sucha 
small form factor. 

“Keeping that same form factor is important. 
An original Raspberry Pi Zero can be removed 
from a project and Raspberry Pi Zero 2 W can 
be plugged into its place. Any application that 
was there beforehand will get a boost from the 
processor performance. 

“Instead of using the single-core processor 
that’s in the Raspberry Pi Zero, we’ve got a quad- 
core Cortex-A53 processor, which is similar 
Silicon to the original Raspberry Pi 3 when that 
was announced.” 

Eben: “There’s this whole question of ‘can 
we do it again’ You can use Moore’s Law in two 
ways: you can take an amount of money and fill 
[Raspberry Pi] with more and more computing 
power, or you can take the current amount of 
computing power and deliver that at a lower and 
lower cost. And that’s what we did with Raspberry 
Pi1- we took a ten-year-old PC’s processing 
power and delivered it at around $30. And then 
we launched Raspberry Pi 2 in 2015 and, lo and 
behold, we’ve done the thing that everyone else 
does: we’ve picked a price point and filled it out 
with six times as much computing power using 
Moore’s Law. 

“Raspberry Pi Zero is really the result of going 
‘Aha! We should do the same thing as we did 
before.’ We should take a Raspberry Pi 1’s worth 
of computing power and we should use Moore’s 
Law to squeeze the price down. 


“Every part on that board pays for itself. It’s 
a single-sided board, and it only has reflowable 
components; it doesn’t have any through-hole 
components. So it can all be manufactured simply 
and robotically. 

“So, coming up to the sixth anniversary, and 
how to use everything we’ve learned from those 
five years, there’s this whole question of ‘can 
we do it again’? And we’ re delivering most of 
Raspberry Pi’s 3 power for not much more than 
half the price of a Raspberry Pi 3. 

“The reality is that earlier this year people 
found out that Raspberry Pi knows how to make 
their own silicon [see, Raspberry Pi RP2040 in 
Raspberry Pi Pico, magpi.cc/102 — Ed]. Raspberry 
Pi Zero 2 W is not our own silicon, but we package 
Silicon in unusual ways 


Simon: “It’s also known as a ‘stacked package’. It’s 
the concept of putting more than one monolithic 
piece of silicon into a package to make a full system 
and package device. There’s a BCM2710A1 SoC 
(system on a chip) in there and half a gigabyte of 
DRAM. These are both gold-wire stitched to the 
substrate. That is then encapsulated to make the 
package. And so, by doing this, we can get two chips 
into the space of one. 

“Because the chips are similar sizes you need 
to use a Silicon interposer, or spacer, amongst the 
centre of the processor. Then, when you put the 
memory on top, it doesn’t squash the gold wires 
that connect the processor to the substrate. The 
memory is very sensitive, so there’s less desire to 
put anything on top of the memory, which is why 
the SoC goes on the bottom and the memory on top. 

“The A53 was the highest performance chip 
that we’ve ever used that used wire bonding in 
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the package, and Raspberry Pi Zero 2 W displays 

a considerable uptick in performance. Single- 
threaded performance is approximately 40% 
faster than a normal Raspberry Pi Zero. Obviously, 
this is quite cool, but if you do a benchmark of the 
single-core on a Raspberry Pi Zero and compare it 
to the quad-core of Raspberry Pi Zero 2 W, you get 
more than five times the performance. Real time 
performance is around three times the speed. A 
Raspberry Pi Zero takes around 90 seconds to boot 
into the GUI, whereas Raspberry Pi Zero 2 W takes 
around 30 seconds. 

“Tt’?s a small board, and if you are willing to help 
out by putting a heatsink on it, or if you put it in 
some sort of metal case where the heat can be 
drawn away from the chip, then it is possible to 
add voltage to the device so you can run it faster.’ 
A Raspberry Pi Zero 2 W with a cooling solution 
can generally sustain 1.2GHz performance.” 

Eben: “We use thick copper inside the board. 
So, effectively, we dissipate the heat throughout 
the board. So if you look at Raspberry Pi Zero 2 W 
with a thermal camera, you’ll see that it gets hot 
throughout the board. That’s because we’ re using 
copper to move heat away from the CPU. 


) 


Get to Know what the numbers on the Raspberry Pi 
Zero 2 W's SIP mean: 


This is the SIP design number. The Ao 
refers to Raspberry Pi Zero, and the AU indicates 
the use of gold wiring. The first models used copper 
wires but it was changed to more expensive gold 
wiring to maximise long-term reliability). 


The week of manufacture (read right to left). 
Ours indicates the 41’st week in 2020. 


The date the batch was ordered (read right 
to left). In this case, 26 August 2020. 


“The can [Wireless Lan enclosure] is a forward- 
looking thing to the days where people want to 
design this into things. We’ve got to be upfront: 
there’s not a huge amount of stock for the first 
year because ‘hey, there’s a global semiconductor 
shortage.’ Looking ahead, this is a product that’s 
going to be around for a long time, and we hope 
people will put it into product designs for OEMs.” 





There are many retro gaming projects for Raspberry 
Pi, and Raspberry Pi Zero lends Itself extremely well 
to small, handheld consoles. Attach a screen, battery, 
consoles, and a 3D-printed case, and you're good to 
play handheld classics. 

There are some handy kits you can get to help build 
your handheld console, like this RetroFlag GPi Case. 
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RETAOFLAG GPi CASE 





Practice checking on your ticker with this simple heart 
rate monitor using the Enviro pHAT from Pimoroni, as 
well as a Pulse Sensor Amped. Put together by Jon 
Witts, it measures live heartbeats and displays the 
results on a Scroll pHAT HD. 





Raspberry Pi Zero 2 W has the CSI (camera 

serial interface) port found on most Raspberry Pi 
computers, enabling you to connect a Raspberry 

Pi Camera Module to the device. And the official 
case has a cover with a pin-hole space for the 
camera. Many makers have taken things further with 
3D-printed cases and LCD screens. Take a look at 
PolaPi-Zero for inspiration, and a guide to make your 
own Raspberry Pi Zero 2 W camera. 
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Dashcams can be attached to your car to record 
video in case of an incident. ZeroView is a mount 
with suction cups designed to house Raspberry 

Pi Zero. It includes a mount for your Raspberry Pi 
Camera Module. The cups enable it to be attached 
to a car windscreen, or any other type of window. 





Raspberry Pi Zero 2 W Is great 
for powering an e-ink display, 
which draws less power than an 
LCD. The combination is perfect 
for presenting this always-on 
calendar that updates once an 
hour, or at the press of a button. 
Zonglin Li has infused the front- 
end with numerous widgets and 
an LED lights up when the screen 
is being refreshed. 


The Mood Light is a Raspberry Pi Zero project kit 
from Pimoroni. It uses the GPIO pins on Raspberry 
Pi Zero to connect to a Unicorn pHAT with 32 RGB 
NeoPixel LEDs. You can set these to a single colour, 
or fade them through all the colours of the rainbow. 
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ongratulations on becoming a Raspberry 

Pi Zero 2 W owner. We’re sure you’ |l enjoy 

discovering a whole new world of computing 
and the chance to handcraft games, control robots, 
build machines, and share your experiences with 
other Raspberry Pi fans. 

Getting started won’t take long: just corral the 
extra bits and bobs you need on our checklist. To 
get set up, use Raspberry Pi Imager to set up a card 
and connect all the cables. This guide will lead you 
through each step. You’ll find Raspberry Pi OS, 
including coding programs and office software, 
all available to use. After that, the world of digital 
making with Raspberry Pi awaits you. 





All the bits and bobs you need 
to set up a Raspberry Pi computer 


You’ ll need a microSD card witha 
capacity of 8GB or greater. Raspberry Pi 
Zero 2 W uses it to store the operating 
system and store programs and files. 

If you want to reuse an old card, you’ ll 
need a card reader: either USB ora 
microSD to full-sized SD (pictured). 











You’ll need a Linux PC (such as another Raspberry 
Pi), Windows Linux PC, or Apple Mac computer, 

to run Raspberry Pi Imager to download and write 
Raspberry Pi OS onto a microSD card for Raspberry 
Pi Zero 2 W. 





Like any computer, you need the means to 

type commands, create code and documents, 
and otherwise control Raspberry Pi. You can 
use a Bluetooth keyboard, but the initial setup 
process is much easier with a wired keyboard. 
Raspberry Pi sells an official Keyboard and Hub. 
magpi.cc/keyboard 


Raspberry Pi Zero 2 W uses 
the same type of micro 

USB power connection as 
many old electronic devices. 
So you can recycle an old 
USB to micro USB cable 

and a smartphone power 
supply. Raspberry Pi also 
sells official power supplies 
(magpi.cc/products), which M 
provide a reliable source ~ 
of power. 





A standard PC monitor is ideal, as the screen will 
be large enough to read comfortably. It needs to 
have an HDMI connection, as that’s what’s fitted 
on your Raspberry Pi board. Raspberry Pi Zero 2 W 
needs a mini HDMI to HDMI cable (or adaptor). 
magpi.cc/minihdmi 


A HDMI cable, such as 
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Get it connected 

As you’re setting up a Raspberry Pi Zero 
2 W, you’|l need to use a USB-A to micro USB-B 
cable (or adaptor) to connect a keyboard to the 
smaller connection on a Raspberry Pi Zero W. One 
is included with the official keyboard, which also 
has additional USB-A ports to accept the mouse 
and other accessories. Or you can use a cable with 
your own keyboard. 


Mouse and keyboard 
You can either connect your mouse to a 
USB socket on your keyboard (if one is available), 


PV Ui care M aatelutsy-me) m<-\veley= 1 ce M mexe)alal=rein-ve co mdal-maalloige) 
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(magpi.cc/usbadaptor). 





then connect the keyboard to the micro USB socket 
(via the micro USB-A to USB-B adapter). Connect 
your mouse to one of these if possible. If not, 
you’ ll need a USB HUB so you can connect both the 
keyboard and mouse to the single USB-B socket. 


More connections 

Now connect your full-sized HDMI cable 
to the mini-HDMI to HDMI adapter, and plug the 
adapter into the mini-HDMI port in the middle of 


your Raspberry Pi Zero 2. Connect the other end of 
the HDMI cable to an HDMI monitor or television. 


Set up the software 

Now you’ ve got all the pieces together, 
it’s time to install an operating system on your 
Raspberry Pi so you can start using it. Download 
Raspberry Pi Imager from magpi.cc/imager. This 
utility is available for Windows, macOS, and Linux 
computers, so choose the relevant version for 
your system. 


Write the OS to 

the microSD card 
Attach your microSD card to your PC or Mac 
computer, and launch Raspberry Pi Imager. Click 
the ‘Choose OS’ button to select which operating 
system you would like to install. The top option 
is Raspberry Pi OS (32-bit). With an OS selected, 
click the ‘Choose SD card’ button and select 
your microSD card (typically there will be just 
one option). 

Finally, click the ‘Write’ button and wait while 
the utility writes the selected OS to your card and 
then verifies it. When complete, you may remove 
the microSD card. 





Assemble your Raspberry Pi 

Now it’s time to physically set up your 
Raspberry Pi. Plug your PC monitor into the mains. 
Remove the microSD card from the SD card adaptor 
and slot it into the underside of your Raspberry Pi 
Zero 2 W. 


Power up 

Plug in your Raspberry Pi power supply 
and, after a few seconds, the screen should 
come on. Raspberry Pi OS will boot up. When 
Raspberry Pi OS first loads, you will need to set a 
few preferences. Click Next, when prompted, then 
select your time zone and preferred language, and 
create a login password. You’re now ready to get 
online. Choose your WiFi network and type any 
required password. Once connected, click Next to 
allow Raspberry Pi OS to check for any OS updates. 
When it’s done so, it may ask to reboot so the 
updates can be applied. You’ re all set to start 
enjoying computing with your very own Raspberry 
Pi Zero 2 W. 
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ensory world: 


Build a fire 
and gas leak 
alarm system 


Enable Raspberry Pi to detect flames and gas leaks to raise an alarm 


umans experience the world through a 
range of senses. This enables us to be aware 
of whatever’s happening in our environment 
so that we can react to it. 

So, it makes sense (no pun intended) that your 
Raspberry Pi would also benefit from being able to 
sense things. Fortunately, this is made possible 
using a wide variety of electronic sensors. In this 
series, we’ll explore some of the most commonly 
available sensors and their use cases. 

To start off, we’ll build a simple fire and gas leak 
alarm system using a couple of sensors. When 
either hazard is detected, a visual and audible alert 
will be triggered. 


H 


WV Figure 1 The wiring diagram for the complete alarm system, 
including two sensors, LED, and buzzer 
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Connect flame sensor 

For this tutorial, we’re using the 
flame sensor from the Waveshare Sensors 
Pack, available in the UK from The Pi Hut 
(magpi.cc/wavesensors), and also sold separately, 
but any similar sensor should work in a similar 
way. It uses PIR (passive infrared) to detect a 
change in temperature nearby. While the sensor 
has pins for both analogue and digital outputs, 
we only need the latter for our alarm, as a nearby 
flame will set the digital output to high. 

With the power turned off, connect the flame 
sensor to Raspberry Pi, as in Figure 1 (where it’s 
at the bottom). We’re powering it from Raspberry 
Pi’s 3V3 pin, grounding it with a GND pin (both via 
the breadboard side rails), and the digital output 
(marked DOUT on the sensor) is going to GPIO 21. 


Flame test code 
With the flame sensor wired up, turn on 
Raspberry Pi. You should see the sensor’s red 
power LED light up if it’s connected correctly. 
To start with, we’ll create a simple Python 
program, as in the flame_test.py listing, to 
read the sensor and print out a message when 
triggered, to check that it’s working correctly. 
From the desktop menu, go to Programming and 
open the Thonny IDE to start coding. 
To simplify the setup, we’re using the GPIO 
Zero library rather than RPi.GPIO; at the top of 





The MQ-5 gas sensor can detect 
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our code, we import the Button method from it. 
We’ll use this to sense when the digital output 
from the sensor is high, in effect the equivalent 
of a push-button being pressed. As it’s connected 
to GPIO 21, we assign the flame object to this with 
flame = Button(21). 

In an infinite while True: loop, we check 
whether the pin is high (if flame.value == 1) 
and set the message (msg1 variable) that we’ll be 
printing to the Thonny Shell area accordingly. 

In our print statement, we add the end = "\r" 
parameter so that the message is always printed 
on the same line, which is a lot neater than using 
a new line each time. 


Flame on! 

Now it’s time to test our sensor by putting 
a flame near to it to see if it triggers our alarm 
message. We used a disposable lighter for this, but 
you could just light a match. Always be careful with 
fire, though, and don’t get the flame right next to 
the sensor as it’s not fire-proof! 

Run your flame_test.py Python code and then 
move the flame towards the sensor. Ours triggered 
at around 30cm distance, but the sensitivity can be 
altered by using a small crosshead screwdriver to 
adjust the screw on the sensor board — other flame 
sensors may have a potentiometer rotary knob on 
board for this purpose. 

When the flame is close enough to trigger the 
sensor, another red LED lights on ours to indicate 
this. The message printed in the Thonny Shell area 
should change from ‘No fire’ to ‘Fire!’. 
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flame_test.py 


> Language: Python 


Q01. from gpiozero import Button 


02. 

Q@03. flame = Button(21) 

Q04. msgl = °" 

05. 

Q06. while True: 

Q07. if flame.value == 

008. msgl = "Fire! " 
209. else: 

010. msg1 = "No fire" 
Q11. print(msg1, end = "\r") 





Add a gas sensor 

So, we have our flame sensor working 
correctly. Now it’s time to add the gas sensor to 
our setup. We’re using a Waveshare MQ-5 sensor 
for this, as featured in the Sensors Pack, but other 
Similar gas sensors are available. The tin oxide 
layer inside the sensor has a high sensitivity to 
the presence of gases such as butane, methane, 
and propane. 

The sensor has pins for analogue and digital 
outputs, but we only need the digital output for 
our alarm. We connect that pin (DOUT) to GPIO14, 
and the VCC and GNC pins to 3V3 and GND (shared 
with the flame sensor via the breadboard side 
rails), as in Figure 1 (gas sensor at the top). 
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DOWNLOAD 
THE FULL CODE: 


magpi.cc/github 


TopTip @ 


Analogue out 


For simplicity, 
we've used the 
digital outputs 

to trigger our 
alarm. To use the 
analogue outputs, 
you'll need to 
add an ADC chip 
(e.g. MCP3008) to 
convert them to 
digital readings. 


| You'll Need 


>» Flame sensor 
magpi.cc/ 
flamesensor 





>» MQ-5 gas sensor 
magpi.cc/ 
gassensor 


> LED 
>» Active piezo buzzer 


> Jumper wires 
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A Testing the flame 
sensor with a lighter. 
Be careful not to 
move it too near 
the sensor or other 
components! 


Off board 


We've placed our 
sensors on the 
breadboard, but 
you could keep 
them separate 
from the other 
components and 
wire them up from 
there, with the 
digital outputs 
wired directly to 
the GPIO pins. 





flame_gas_test.py 





>» Language: Python 


Q01. from gpiozero import Button 
02. 

Q03. flame = Button(21) 

Q04. gas = Button(14) 


Q@0@5. msgl = °" 

Q06. msg2 = "" 

007. 

Q0@8. while True: 

G09. if flame.value == 
Q10. msg1 = "Fire! " 
Q11. else: 

Q12. msg1 = "No fire " 
Q13. if gas.value == 

Q14. msg2 = "Gas leak!" 
Q15. else: 

016. msg2 = "No gas’ " 
Q17. print(msg1, msg2, end = "\r") 





Add gas to code 

While we could create a new program to 
test the gas sensor separately, we’ ll add it in to our 
previous code as it will then be simpler to rework it 
into our final alarm code later. 

In the flame_gas_test.py listing, we assign the 
gas object to GPIO18 with gas = Button(14). As 
before, we’re using the Button method to detect 
when the pin is triggered and thus set to high. 

We add a new msg2 variable, which we’|l set to 
the message we want to print in the Shell area. 
This is done by adding some extra lines to our while 
True: loop. If the gas sensor pin is triggered (if 
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gas.value == 1), then the message will be set to 
‘Gas leak!’; if not, it’1l be ‘No gas’. 

We add msg2 to our print statement, after msg1, 
again including the parameter end = "\r" so the 
message is always printed on the same line. 


Turn on the gas 

Now it’s time to test our gas sensor to 
check it’s wired up and working correctly. As 
before, we’re using a disposable lighter for this, 
pressing the button to release a little gas without 
igniting it for the flame. You could use gas from a 
hob or cylinder, but you only need a tiny amount 
to trigger the sensor, so be sure to turn it off again 
after a couple of seconds. 

Run your flame_gas_test.py Python code 
and then release a little gas in the vicinity of 
the sensor. As with the flame sensor, the gas 
sensor’s sensitivity can be altered by using a small 
crosshead screwdriver to adjust the potentiometer 
screw on the sensor board. 

When the presence of gas is detected and the 
sensor is trigger, another red LED lights on ours to 
indicate this. The second message printed in the 
Thonny Shell area should change from ‘No gas’ to 
‘Gas leak!. 





™ The gas sensor's sensitivity 
can be altered 


07 Let there be light 
If your sensors and code are working 

correctly, and the correct messages are shown 
when they’re triggered, it’s time to move on to 
the next part. Printed messages are all very well, 
but for a proper alarm you need a visual and/or 
audible alert. 

For the visual side, we’ll add a standard red 
LED to our setup — ours is 5mm, but you can use 
any size. As always when using LEDs, a resistor 
is required to limit the current to make sure it 
doesn’t receive too much and potentially burn out. 
With the LED placed in the breadboard, with legs 
in different unconnected rows, we connect a 330Q, 
resistor between the negative (shorter) leg and the 
eround rail of the breadboard. The positive (bent, 
longer) leg is connected to GPIO16 on Raspberry Pi 
(as in the Figure 1 wiring diagram). 








A The Waveshare flame sensor has both analogue and digital 
outputs. Sensitivity can be adjusted with the screw 





Get a buzz 
For our audible alert, we’re using a small 
active piezo buzzer to make a beeping noise. The 


buzzer will have a longer positive leg and a shorter 


negative one; their positions may also be marked 
on top of the buzzer itself. Connect the negative 
pin to the breadboard’s ground rail and the 
positive pin to GPIO 25 (as in Figure 1). 


Alarm code 

With everything wired up as per Figure 1, 
you're now ready to program your fire and gas 
alarm. In the final code, fire_gas_alarm.py, we 
add LED and Buzzer to the gpiozero imports at the 
top. We also import sleep from the time library, to 
use as a delay. 

We create two functions, one for each type of 
alarm: fire_alarm and gas_alarm. Each uses a for 
loop which toggles the LED and buzzer on and 
off a set number of times, with a 0.5 sleep delay 
each time. 

Finally, in awhile True: loop, we check the pin 
values and trigger the relevant alarm when the 
pin receives a signal from the sensor. If neither 
is triggered, we show the default message and 
ensure the LED and buzzer are turned off. 


Sound the alarm 

Now to test the alarm system. As before, try 
positioning a flame near the fire sensor to check 
that the alarm is triggered, in which case the LED 
will blink and the buzzer will beep. Do the same 
for the gas sensor by releasing a small amount 
of gas; the alarm will sound again. Each time, an 
appropriate message will show in the Shell area. 


Taking it further 

We now have a simple working fire and gas alarm. 
To make the alert more obvious, you could add 

a relay switch to turn on a12V tower light with 











A The MQ-5 gas sensor can detect several noxious gases in the air 
and is highly sensitive 


buzzer (e.g. magpi.cc/towerlight). You could also 
send an email or push notification alert to your 
phone whenever the alarm is triggered. 

Next time we’ll create an intruder alarm using 
noise and laser sensors. See you then. Wl 


fire_gas_alarm.py 


> Language: Python 


001. 
002. 
003. 
004. 
005. 
006. 
007. 
008. 
009. 
010. 
G11. 
012. 
013. 
014. 
O15; 
016. 
017. 
018. 
019; 
020. 
Q21. 
Q22. 
Q23. 
Q24. 
O25: 
Q26. 
Q27. 
028. 
Q29. 
030. 
Q31. 


from gpiozero import Button, LED, Buzzer 
from time import sleep 


flame = Button(21) 
gas = Button(14) 
led = LED(16) 
buzzer = Buzzer(25) 


def fire _alarm(): 
print("Fire! ", end = "\r") 
for i in range (10): 
led.toggle() 
buzzer. toggle() 
Ssleep(@.5) 


def gas alarm(): 
print("Gas leak!", end = "\r") 
for i in range (10): 
led.toggle() 
buzzer. toggle() 
Ssleep(@.5) 


while True: 
if flame.value == 1: 
fire_alarm() 
elif gas.value == 1: 
gas_alarm() 
else: 
print ("All OK 
led.off() 
buzzer .off() 


", end = "\r") 
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Warning! 
Fire and gas 


Never play with fire! Be 
careful when testing 
your alarm and don't 

position the lighter flame 
too close to the sensors 
or other components. 
Only release a small 
amount of gas and do 
it in a well-ventilated 
area. Do not rely on 
this DIY alarm for your 
safety. In the event 
of a real fire or gas 
leak, call the relevant 
emergency service. 








magpi.cc/firesafety 
magpi.cc/gassafety 
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Rob Zwetsloot 





Rob is amazing. He's 
also the Features 
Editor of The MagPi, 
a hobbyist maker, 
cosplayer, comic 
book writer, and 
extremely modest. 
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You'll Need 


>» Keybow 2040 
magpi.cc/ 
keybow2040 


> OBS 
obsproject.com 


>» VoiceMod 
voicemod.net 


> USB-C to 
USB-A cable 


Turn Keybow 
2040 into a 
stream deck 


Reprogram the RP2040 auxilliary keyboard into a 
powerful macro keyboard for streaming and more 






art, playing games, or just chatting with 

followers, it can be great to interact with 
folks while doing something else. 

It is also quite complex to stream. Starting with 

a complicated OBS setup to stream your game, 
and ending up with loads of extra tabs and audio 
mixers thrown in, there can be a lot to control 
and maintain while you’re live, and even more 
to do if you want to use silly audio effects or 
zooms, etc. This is where a stream deck comes 
in, allowing for short cuts for various functions 
at the press of a button. A lot of dedicated stream 
deck products can be pretty expensive, though, 
so let’s make something a lot cheaper and far 
more customisable. 


c treaming is fun. Whether you’re doing 


Construct Keybow 2040 


The Keybow requires some building 
before you use it — it’s fairly simple though. 
You attach some standoffs, a middle layer, 
add the switches to the final plate, add the 
keycaps, and then sandwich it all together. 
There are some illustrated instructions here: 
magpi.cc/keybowbuild. You should be done 
before an episode of The Simpsons is over. 

For stream deck use, we also have a 3D-printed 
switch stand that it fits onto nicely, keeping the 
keys in eyesight (which is important, as we’ll 
explain later). 
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Basic Keybow 2040 usage 
Plugging your newly built Keybow 2040 into 
your PC will activate the pre-installed code that 
turns it into a numpad using a basic HID (human 
interface device) script. The LEDs in the keys are 
turned off, but go green as they are pressed. 
As well as being usable while plugged in, 
you can also access the storage inside and find 
different examples in the examples folder. To use 
one, merely copy it to the top Keybow directory 
and change the file’s name to code. py. 


MA lot of dedicated stream 
deck products can be 
pretty expensive 


Customise your code 

The code.py file is what tells the Keybow 
2040 how to operate. Looking through the 
examples, you’ll be able to see how a lot of the 
individual parts work together. A full list of the 
functions can be found on the Keybow GitHub 
here: magpi.cc/keybowgit. 

As it runs on CircuitPython, based on 
MicroPython, a lot of Python knowledge and 
skills are transferable while writing any custom 
code. With one caveat though — using sleep is not 
recommended by Pimoroni, and it did not work 
with this build either. Still, there’s a lot you can do. 


Lars play Ploteingall Also, testator 'a #8 GR 


MEL <eMe [Ui(ol @eiat-lave(=\-muat-lar-lic-veimycelelg 
1aectolaa MUU ivateleim atc \ilale mxe mae laaleln= 
with all the open applications 


It’s very quick to prototype and test your custom 
code as well — opening, editing, and then saving 
the code.py file will immediately reset Keybow 
2040 so that you can test out your handiwork. 


Keyboard shortcuts 

The basic keys used by the default code 
should be altered if you plan to use this as a 
stream deck. They function as a numpad, and 
while they will work as hotkeys, they may also be 
used normally by the software you’re running. 
Luckily, the Arduino key library allows for 
multiple keys to be sent at once: 


keyboard.send(Keycode.LEFT_CONTROL, 
KEYPAD_ ZERO) 


Keycode. 


In our code, we’re still using numpad keys, but 
we’ ve added the left CTRL key to the combo. You 
could easily use a different key, such as the scroll 
lock, or multiple keys. Just check to make sure 
the key combos you’re planning on using aren’t 
being used in other programs — we don’t want any 
ALT+F4 incidents while streaming games. 


— 
> Controlyour streaming 
with hotkeys activated 


7ge)aamualsmoiiastslaame(=\er.4 


LED colours 

We’ ve opted for all the keys to be lit up 
while the stream deck is connected, and this can be 
done using a simple keybow. set_al1() command, 
where an RGB code is placed in the brackets. 

For our code we’re using green (0, 255, 0), 
yellow (255, 255, 0), and red (255, 0, 0), and you 
can easily add or modify the colours as you see fit. 
All the Keys light up green when the Keybow is on 
(mostly to remind us that it is), and keys will turn 
yellow once activated. The red is used for the mute 
and voice change button when activated, just to 
differentiate them. 

For other colours, blue is a good one (0, 0, 255), 
as well as white (255, 255, 255). If you need another 
shade, simply enter the name of it followed by 
‘rgb’ into your search engine of choice. 


When pressed 

One of two most important parts of our 
code is the press_handler function. As the code 
cycles, it waits for a key to be depressed before 
it starts doing anything. It gets told which key is 
being depressed, finds out which part of the key 
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Top Tip 


Manual 
combos 


: CEE, “A 





The key combos 


you've set up 


can also still be 


done on your 


regular keyboard, 
in case you need 
a backup way to 


use a hotkey. 
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Here's how the 

keys are laid out on 
Keybow 2040 related 
to the code 


OBS focus 


You may find 
some difficulties 
using hotkeys with 
OBS - make sure 
the window is in 
focus for them. 


Adding hotkeys to 
OBS Is very easy, and 
it can control just 
about every aspect 
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VOICE 
CHANGER 


—_——_—_—_—_—_—_—j- 





SOUND 
EFFECTS 


—_ 


AUDIO 
CONTROL 
{> 


OBS 
CONTROL 
> 


combo it should use, and then sends that asa 
key press. 

We also have an if statement so that a specific 
key turns to yellow when depressed, as all this 
button does is stop any sound effects from 
playing — it can easily be applied to other keys by 
modifying this if statement. 


07 When released 
By having separate press and release 

functions, we save the code treating a button- 
press as multiple events. We can also define what 
happens when the button is released; in this case 
we change the colour of the key to indicate that 
it’s been used, as well as updating the keytoggle 
list, which we use to remember the state of the 
key (on or off, 1 or 0) 

As we have many different buttons doing 
different things, we’ve racked up a long if 
statement — most are simply ‘change between two 
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USB CABLE 


colours’; however, one of them treats a series of 
three keys differently: elif key.number >= 1 and 
key.number <= 3. Only one may be lit yellow ata 
time, and we’ll be using this to select a type of 
voice modification. 

The and here also works as a Boolean operator, 
where AND means only if it satisfies both 
requirements, and OR means if it satisfies at least 
one requirement. 


Planning your layout 

For the code in this tutorial, we’ve set up 
the keys in categories, as shown in Figure 1. Keys 
O-3 on the top line handle voice changing, the 
second row we use for sound effects, the third line 
for muting and stopping sound effects, and the 
last line for OBS hotkeys. 

Remember, the keys go from 0 to 15 only when 
the Keybow is orientated with the USB cable 
sticking out of the right side. 

Depending on your stream deck uses, you can 
make your own layout; however, be aware of the 
placement when programming. 


Special keys 
Our mute key and voice change key both 
turn red when activated. These are both important 
keys in the setup and if you’re a bit forgetful, like 
us, you may not realise that the voice change key 
is still on until a helpful member in chat points 
out that you sound like a robot. 

They broadly function the same as any other key 
pressed; however, the differing colours do help 





VOICEMOD 


Lor NT Cool Tune 
LCtri + Pad? LCtri + PadS 


Telephone 
LCtri + Pad2 


when you’re trying to quickly bump a key while 
drifting a Ferrari around LA. 


Toggle keys 
The keys 1, 2, 3 we are treating as toggle keys, 
as explained above. Here is how the code works: 


key.set_led(*rgb2) 
keytoggle[key.number] = 1 


This part sets the key to yellow, and changes the 
keytoggle list to on/1 for that key. 


if key.number != 1: 
keys[1].set_led(*rgb1) 
keytoggle[1] = @ 


This part checks to see if key 1 was not pressed, 
and the following two statements check for keys 2 
and 3. If those keys were not pressed, the colour is 
returned to green, and the keytoggle is set to off/o. 


Our mute key and voice 
change key both turn red 
when activated 


OBS hotkeys 

Just about every element in your OBS setup 
will be able to have a hotkey attached — whether 
it’s simply changing to a scene, showing and 
hiding an image, or to stop streaming. From OBS, 
click Settings and then select the Hotkeys tab. 

Click on the bar next to the function you’d like 

to hotkey, and then press the desired Keybow key. 


DOWNLOAD 
THE FULL CODE: 


yy) magpi.cc/streamdeck 


env 





It will not only set the hotkey but also tell you 
what it is —- a good way to check that your code 
worked properly. 


VoiceMod hotkeys 

VoiceMod is a great piece of software 
for doing fun voice changers, playing sound 
effects, and generally controlling the entire 
audio input for your stream. Selecting a 
modifier, you’ll see a button to add a hotkey - 
click that and use the desired Keyboy 2040 key. 
The same is true for any sound effects or clips 
you upload. 

In the Settings, you can also add other 
hotkeys — for the code we’ve used, key 0 is for 
voice changer toggle, key 8 for mute/unmute, 
and key 9 for stopping any sounds. 


MagPi 


The free version of 
VoiceMod offers many 
features, and they all 
work with hotkeys 


Elevating and angling 
a stream deck can 
make it easier to 
press buttons... and 
remember it’s there 
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K.G., 
Orphanides 





K.G. holds that 
digital audio 
hardware peaked 
in the 1990s 

and is prepared 
to die on this 
preposterous hill. 


@KGOrphanides 


You'll Need 


> USB to 5-pin MIDI 
cable 


>» An external MIDI 
sound card 


> ScummVM 
magpi.cc/ 
scummvm 


>» DOSBox-X 
magpi.cc/dosboxx 





Connect retro 


MIDI hardware 
to Raspberry P1 


External MIDI sound cards like the Roland MT-382 were the peak of computer 
music in the 1980s and 1990s. They still work just as well today 


of 1980s and early 1990s computer music 

production and playback. We’ve used a 
Roland MT-32 and SC-55 in this tutorial, but you 
can use most external MPU, MT-32, GM, GS, or 
XG MIDI devices from the era. Although some 
current hardware MIDI sequencers are marketed 
to musicians, modern consumer audio interfaces 
usually lack integrated MIDI voices, and even early 
2000s implementations can suffer variable General 
MIDI sound bank quality. However, the Serda 
3XMA (magpi.cc/x3m) is a well-regarded and, at 
€79 (£68), relatively inexpensive modern USB MIDI 
interface with sound banks designed for backwards 
compatibility with the SC-55. 


E xternal MIDI sound cards were the pinnacle 


Hook me up 

If you’re using original 1980s or 1990s 
hardware, start by connecting your MIDI-to-USB 
cable. This has a standard USB Type-A plug on one 
end, and a pair of 5-pin DIN MIDI plugs on the other. 





_ DAnéchons- JACK Audié Corinection Kit 





Audio MIDI A 


Readable Clients / Output Ports 
Pi 14:Midi Through 
HO 20:US8 MIDI interface 
Ba ax Wireless 2 
a | 130: Otractor 


Writable Clients / Input Ports 
Pj 14: Midi Through 
1 20:USB6 MIDI interface 
pe P 24:Vortex Wireless 2 
~~ pp We0cotrect 











A Above Here, we're using Jack's Connect interface to connect 
Qtractor to our MIDI interface, and our Vortex Wireless MIDI 
keytar to Qtractor. Think of the lines as patch cables 
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Connect the MIDI OUT plug on the lead to the 
MIDIIN port on your audio interface. The MIDI IN 
plug on the cable goes into the MIDI OUT port on 
the sound card. Power up your external audio device 
and make sure you’ve connected headphones or 
speakers — audio connections vary. Our MT-32 rev o 
has only a pair of 1.4-inch TRS outputs, so make sure 
you have appropriate cables and adapters. On some 
devices, you should keep the MIDI device volume 
low to avoid crackling. Similarly, if you accidentally 
attach the MT-32’s right output to your speaker’s 
left channel and vice versa, your sound will be 
overwhelmed by static upon playing anything. 


Power me on 

Connect the USB-to-MIDI cable to a USB 
port on Raspberry Pi and power on. Raspberry Pi OS 
should detect it as an ALSA device. We’ll check that 
it’s there and then run a couple of tests to make 
sure it’s plugged in, discover its port number, and 
play a MIDI file. Open a Terminal and enter: 


amidi -1l 

sudo apt install pmidi 

wget wiki.ultimacodex.com/images/8/80/ 
Stones.mid 

pmidi -1l 

pmidi -p 20:0 Stones.mid 


The port number after -p should be whatever 
pmidi -1 reports your device as. If pmidi doesn’t 
list any devices, reboot Raspberry Pi. We’re going 
to need MIDI sequencer software next, so let’s 
erab Qtractor and Jack right away. At the Terminal, 
enter: sudo apt install qjackctl gtractor. 





A Above Ctractor is a simple but effective Digital Audio Workstation 
(DAW) capable of handling MIDI files and composition 





Jack in 

To minimise latency, we’re going to be using 
the Jack Audio Connection Kit, which should have 
been fully installed as a dependency of gjackctl. At 
the Terminal, type: 


qjackctl 


Now click Setup and, at the right of the screen, 
set MIDI Driver to seq from the pull-down. Leave 
the Advanced tab at default settings - if you’ve 
previously edited your Jack profile, you may need 
to reset the Output and Input Device fields to 
‘(default)’. Do not select your USB MIDI interface 
here, as Jack is looking for PCM audio support and 
will crash without it. 

From Raspberry Pi’s applications menu, go to 
Sound and start Qtractor. 


Import to DAW 


Time to try our Digital Audio Workstation. 
In Jack’s main window, select Connect and click 
the ALSA tab. Select Qtractor from the left column 
(Output ports) and USB MIDI Interface from the 
right (Input ports), then click Connect. A line 
should appear between them. 

In Qtractor, in anew project, go to the 

Track menu > Import tracks > MIDI. Select the 
Stones.mid file we were using earlier. This should 
open several tracks in Qtractor. Click the <| button 
to make sure the play head is at the beginning, 
then hit play. You should be able to hear and see 
our MIDI file. 


How about MIDI input? 


You can manually use Qtractor’s piano roll 
to create and edit music. But if you have a MIDI 
instrument with either a USB connection or another 
5-pin DIN and USB adapter, you can use that as 
a control surface to record or play music directly 
through your retro MIDI device. Plug in your 


Uniquely, the Roland MT-32’s 
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games take advantage of, like 
Sierra's Quest for Glory II 


This £10 5-pin DIN MIDI to USB adapter 
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like the £35 Roland UM-ONE-Mk2 are worth 
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on-screen messages 





instrument, create a new Qtractor file, and go back 
to the ALSA tab in Jack’s Connect window -— restart 
Jack if your MIDI instrument doesn’t show up. 
Connect your MIDI instrument on the left to 
Qtractor on the right, and Qtractor on the left is 
connected to your USB MIDI Interface on the right. 


Your own composition 

Go back to Qtractor, right-click in the 
left-hand pane, and select Add Track. Select Type: 
MIDI, Channel: 2, and Program: 17 for an MT-32 
harpsichord — or Program: 7 for GM hardware. 
Click OK and play. If that works, make sure you’re 
at the start of the track, press record, play, and you 
can now record real-time MIDI input. Give each 
track its own channel - the MT-32 supports up to 
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Above The MT-32 defaults to receiving MIDI on channels 2-9; 
press the MASTER VOLUME and 5 buttons at the same time, then 
tap 1 to switch it to a more conventional channel 1-8 configuration 





eight simultaneous channels, plus percussion. The 
SC-55 and other General MIDI cards support up 

to 16. You’|l notice that Qtractor doesn’t display a 
patch map with instrument names. You can find 
an MT~-32 list at magpi.cc/mt32 and a list of the 
GM GS instruments used by the later devices on 
Wikipedia (magpi.cc/midievents). 


Add real MIDI to ScummVM 


ScummVM allows you to play a wide 
range of retro and even modern games, from the 
classic LucasArts titles it was first designed for, 
to adventures by Sierra, RPGs by SSI, and modern 
AGS adventures. 

Go to magpi.cc/scummvmdownloads and 
download the ‘Raspberry Pi 3/4/400 with Raspberry 
Pi OS 32 bits (armhf)’ AppImage. Then download 
Beneath a Steel Sky - Freeware Floppy Version 
from magpi.cc/scummvmgames and extract it 
somewhere convenient. 

In your file manager, right-click on the 
ScummVM AppImage, select Properties, click the 
Permissions tab, and set the Execute pull-down 
to Anyone. Click OK, then double-click the file to 
launch it. 


MIDI configuration for ScummVM 

ScummVM uses ALSA to output to your MIDI 
device. Although they can work together, stop Jack 
to avoid potential conflicts during configuration. In 
ScummVM, click Options. In the Audio tab, select 
your USB MIDI Interface as your preferred output 
device. In the MIDI tab, select it as your GM device. 
Finally, in the MT-32 menu, select your MIDI 
interface as the device and, depending on what 
hardware you have, tick either True Roland MT-32 
or, if you’re using an SC-55 or similar GM/GS 
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Above More readily available than the MT-32, the Roland 
SC-55 and its successors use a particularly lovely-sounding 
General MIDI sound bank 


synth, Roland GS device. Click OK to return to the 
main screen. 

Select Add Game, navigate into the directory 
where you extracted Beneath a Steel Sky, and click 
Choose. Select the game’s entry and click Start. 
The theme music should play through your MT-32, 
while SoundBlaster-compatible sound effects will 
come through Raspberry Pi’s PCM output. 


Do it in DOSBox-X 

ScummVM can’t play everything from that 
era, so we’ll configure DOSBox-X to use our MIDI 
device, too. Open a Terminal and type: 


sudo apt install automake libncurses-dev nasm 
libsdl-net1.2-dev libpcap-dev libfluidsynth- 
dev ffmpeg libavdevice58 libavformat-* 
libswscale-* libavcodec-* 

git clone https://github.com/joncampbel1123/ 
dosbox-x.git 

cd dosbox-x 

./build 

sudo make install 

dosbox-x 


ki - -- 





Top Tip 


SC-55 in 
software 


If you want GM 
sounds without 
hardware 
tinkering, 
download 
FluidSynth and 
direct your MIDI 
output through 
that via Jack. 


WIZnet Order Online 








e Raspberry Pi Pico H/W pin compatible 








¢ W5100S integrates hardwired TCP/IP stack = re for Raspberry Pi Pico) uum 
with 10/100 Ethernet MAC and PHY | yy J IRE Stones St be. 
* Supports hardwired internet protocols: TCP, UDP, Ms - Winer» 
WOL over UDP, ICMP, IGMPv1/v2, IPv4, ARP, PPPoE PSO SeSatedeteseiensieneaesesesons 


MCU : RP2040 


7 
’ 
Fk J@ 


of eledefeel clefofefel elefehebe) olele! 





e , "hbo neon 2550S - We e Ethernet connectivity IC : W5100S 
>) | re Ke Her My ey Ns we Te 
eee = BS Ss : ¢ Micro-USB B port for power and data 
> re guuniutiie a # one = pe ot 
———— Se is * - a) e 23 GPIO are digital-only and 3 ADC capable 
~ | Made by WiZnet eopepeyenere e open e efepe 


e 3-pin ARM Serial Wire Debug(SWD) port 


W5100S-EVB-Pico 





VAAN AP 4 pl =tae le 


TS MagPi | TUTORIAL 


This famous Roland MIDI synth became a byword for PC MIDI audio before the GM standard 
General MIDI, a 1991 standardised spec for MIDI-controlled sound generators 





General Standard/General Sound, a Roland standard that expands GM with extra sounds 
Yamaha's 1994 EXtended General MIDI standard, with up to 480 instruments 


At DOSBox-X’s Z: prompt, type exit. This will 
create the DOSBox-X config directory, Now we 
can export a config file for easier customisation. 
Restart DOSBox-X and, at the Z: prompt, type: 


CONFIG.COM -all -wcd 
exit 


Configure your MIDI settings. 

Restart DOSBox-X again. Click on the Main 
menu at the top left of DOSBox-X’s menu bar and 
select Configuration Tool. Next to mididevice, type 
alsa. For midiconfig, type the device identifier 
pmidi gave us earlier - 20:0 in our case. If you’re 
using arev O Roland MT-32, you may need to add 
20:0 delaysysex to prevent buffer overflow issues. 
Save this to the config file we set up earlier and 
we’ re ready to try out a game. 


Obtain and extract 

Martian Dreams 

Go to magpi.cc/ultima2 and grab the free version 
of Martian Dreams - you’!l need to create a GOG 
account if you don’t already have one. The supplied 
file requires innoextract to use on Raspberry Pi, so 
open a Terminal and type: 





sudo apt install build-essential cmake 
libboost-all-dev liblzma-dev 

wget https://constexpr.org/innoextract/ 
files/innoextract-1.9.tar.gz 

tar xzf innoextract-1.9.tar.gz 

cd innoextract-1.9 

mkdir -p build && cd build 
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cmake .. 
make 
sudo make install 


Now cd to the directory containing the Martian 
Dreams installer and type: 


innoextract 'setup_ultima_worlds_ of_ 
adventure_2_-_martian_dreams_ 1.0 cs (28044). 


exe 


Copy the MARTIAN folder to a new /dos/games 
directory in your home. Go to that directory and type: 


dosbox-x INSTALL.EXE 


Press ENTER to progress through the options 
until you get to audio settings. Select Roland 
MT-32 or LAPC-1, then select Yes to save and exit. 
Exit DOSBox and, back at the command line, type: 


dosbox-x MARTIAN. EXE 


Tell me more 

Although a number of external MIDI 
sound cards had LCD screens, most just display 
instrument, volume, and similar data. The 
exception is the MT-32, which could display any 
text sent as a SysEx (MIDI system exclusive) 
message to its tiny screen. A number of games, 
including titles by Sierra and LucasArts, used this 
to display references to the on-screen action. 
For more MT-32 utilities and documentation, check 
out magpi.cc/mt32resource. Roland also continues 
to distribute software and documentation for its 
older audio hardware at magpi.cc/rolandtools. {/ 


A See midi.org/ 
specifications 
for more specs 
and standards 
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Make your 
own MT-32 


If you can't get 
an external MIDI 
device, turna 
spare Raspberry 
Pi into one with 
the MT32-pi 
operating system: 
magpi.cc/ 
mt32pigit. 
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PJ Evans 


PJ is a writer, 
software developer 
and tinkerer. His 
server has just told 
him it's time for 
lunch. This might be 
getting out of hand. 


twitter.com/ 
mrpjevans 


Home Assistant can 
control hundreds 

of loT devices 

with customisable 
dashboards like this 





KITCHEN 


Ultimate home 
server: enhance 


_ your network 


Make your ultimate server a network genie with these apps 


n the previous parts of this tutorial, we’ve 
taken a Raspberry Pi 4 and turned it into a 
file sharing, media streaming powerhouse. 
Next we’re taking on your network. There are 

SO many ways to enhance your home (or office) 
network that we can’t hope to fit them into a few 
pages. However, these steps will point you in the 
right direction and hopefully inspire you to make 
your home network smarter, faster, and more 
convenient to use. Follow along and we’|1 automate 
your home, allow you to access your data securely 
from anywhere in the world, and automatically 
protect you from nefarious websites. 


Settle on an address 

A key aspect for any server is that you 
Should know where it is. It seems obvious, but 

a typical home network will assign IP addresses 
dynamically (a system known as DHCP) and 
there’s a fair chance they will change from time 
to time. We normally get around this by using 
zero-config domain names like ‘. local’, but we’re 
going to need a set IP address for our server going 





Hygge Kitchen 


Batohen Lights 
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forward. The easiest way to do this is to ask your 
router to reserve an IP address for your ultimate 
server. We recommend you look at doing this 
before proceeding. Sorry for the vagueness, but 
every router does this differently. 


Home control the easy way 

Want to automate your home? Fancy being 
able to control lights or check a home webcam 
from anywhere in the world? How about if that 
software cost you absolutely nothing? Home 
Assistant is an incredible package that integrates 
a wide range of inexpensive smart devices such as 
Philips Hue, Ikea Tradfri, and many more. Best of 
all, it’s open enough that you can create your own 
activities and integrate your own projects relatively 
easily. Installation on an existing server requires 
a few steps, but a great guide has been written by 
the HA team — magpi.cc/hacore — that we have 
summarised here: magpi.cc/hasummary. 


Getting started with 

Home Assistant 

The first time you run Home Assistant, it’ll take 
a few minutes or so to get its act together as it 
installs everything it needs. HA will also scan 
your network for any existing devices you have. 
Once running, you can access the dashboard at 
http://ultimate.local:8123 (change the name if 
you didn’t call your server ‘ultimate’). You may 
be surprised to see what is already detected and 
available. If not, there are hundreds of plug-ins 
to extend HA’s capabilities. Home Assistant is a 
massive topic, SO you may want to have a read of 
our tutorial in The MagPi #99 (magpi.cc/99). 





/ Our ultimate server now hosts a whole 
od suite of network features in a tiny case 


Add an MOTT broker 


We will absolutely forgive you if this title 
sounds like gibberish. MQTT is a very simple 
protocol for sending messages from device 
to device. It is loved by the home automation 
community, so it’s no surprise it’s well supported 
by Home Assistant. The principle is simple: any 
device can publish its data (e.g. a temperature 
reading) to an MQTT ‘topic’ (a label to describe 
the data stream). Then, any other device can 
‘subscribe’ to the MQTT topic and receive updates 
in real-time. It makes brewing your own sensors 
or switches so much easier as you don’t have to 
know about the target. 


A key aspect for any server 
IS that you should know 
where It Is 


A nice kind of mosquito 

One of the most popular MQTT brokers (a 
server that receives and broadcasts MOTT events) 
is Mosquitto. Installation is very straightforward: 


MagPi 


The Home Assistant app 
lio F-mVfolem Kom aale)alixelar-lare! 
control all kinds of loT devices 





sudo apt install mosquitto mosquitto-clients ; 
You'll Need 

This will install Mosquitto and make sure it’s . 

‘8 Raspberry Pi 
running as a Service at all times. To test it’s 

j } ; Ultimate Server as 
working, open two Terminal windows and run built in The MagPi 
these commands, one in each: #108, #109, & #110 


mosquitto_sub -t "test" 
mosquitto_pub -m "message from mosquitto_pub 
client" -t "test" 


If all is working, you will see a window ‘talking’ 

to the other. Now anything that generates MQTT 
messages can connect with you and your Home 
Assistant server. Just add the MQTT integration in 
HA and you can create graphs, alerts, and more. 


Adding remote access 

Previously, we’ve configured our server to 
stream audio and video and now we can switch 
lights, check the living room, feed the cat, and 
more. So, if you’re not home, how do you do 
thise Remote access to your home network is 
not something to take lightly, as if you can get 
access, what stops someone else? The answer is 
PiVPN, a script that installs a VPN (virtual private 
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Virtual Private Network 


A Av irtual private 


network such as 
Wireguard creates a 


secure encrypted link 


to your home devices 
from anywhere 


TopTip @& 


Building 
your Home 
Assistant 
setup 


The Home 
Assistant 
community 
maintains a list of 
compatible smart 
devices. These 
either work ‘out 
of the box’ or with 
a free plug-in: 
magpi.cc/ 
haplugin 





Home or 


Office 


Router 


network) that you can connect to securely from 
anywhere in the world. Previously PiVPN only 
supported OpenVPN, which can be difficult to 
work with, but now the much simpler Wireguard 
protocol is supported. 


Installing Wireguard 

For lots of information on PiVPN and 
Wireguard, head over to The PiVPN Project at 
pivpn.io. To get started with installation, run the 
following command from a Terminal: 


07 


curl -L https://install.pivpn.io | bash 


The installer will take you through a series of 
questions. An important point is to ensure you 
have a static IP address as your router will need 
to know where to find your Wireguard server. 
When asked what type of server to install, 
answer ‘Wireguard’. Continue through the 
installer, accepting the default answers. If you 
don’t have a static IP address for your router, you 
may need to consider a dynamic DNS service such 
as DynDNS (account.dyn.com) so you can easily 
reach your Wireguard service. 


Using Wireguard 

Before you can use Wireguard to get secure 
remote access to your network, you need to allow 
the internet to ‘see’ it. This is done by creating 
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a port mapping. Your router needs to forward all 
traffic to port 51820 (default) over UDP to your 
server. How to do this varies from router to router, 
so search for your particular router’s instructions. 

To create users that can access the network, 
run this command: 


pivpn add 


Give a username when prompted and a config file 
will be created. Copy that config file to the device 
you want to use to access the network and import 
it using the free Wireguard client software. Now 
you can access your home network from a laptop 
or smartphone from anywhere in the world. 


Add a web server 

The fun thing about web servers is they 
are actually very simple things. You can place 

a text file in the home directory and the server 
will happily serve it anywhere in the world. If 
you would like to be able to access files through 
a web browser, you can combine Wireguard anda 
web server to make access both easy and secure. 
As an example, we’re going to configure access 
to the media library we have previously created. 
First, install a web server: 





sudo apt install apache2 


After that single line, you would be able to access 
a simple welcome page at http://ultimate.local. 


Adding directories to 

your web server 
What a web server can provide you with is only 
limited by imagination. Let’s get simple access 
to our music and videos, which are stored in 
/mnt/huge/Media. Apache has a complex 
configuration system, but we’re going to playa 
little UNIX trick to make things easier: a symbolic 
link. This allows us to map one part of the file 
system to another, creating a kind of short cut. 


sudo In -s /mnt/huge/Media /var/www/html1/ 
media 


Now you should be able to go to http://ultimate. 
local/media/ and browse your files. It isn’t 
pretty, but it’s a start! Now you can connect to 
your network securely and access files easily. 


™ Pi-hole can protect your 
entire network, even 
your smartphone 


Avoid the dodgy advertising 

One of the most popular Raspberry 
Pi applications is Pi-hole (pi-hole.net), a 
clever system designed to ‘sink’ internet 
advertisements, leaving your browser clear of 
noise. While we strongly recommend supporting 
your favourite sites by allowing adverts, many 
sites contain ads that are not only scams, 
but can lead to tricking you into downloading 
malware that can compromise your data. 
Pi-hole can protect your entire network, even 
your smartphone. To install it, simply run this 
command from a Terminal: 


curl -sSL https://install.pi-hole.net | bash 


The installer will ask several questions, but is 
well-designed and you’re probably going to be 
OK to answer every one with the default answer. 


Starting off with Pi-hole 


Pi-hole works by looking at DNS requests. 
These are requests to servers that map domain 
names such as raspberrypi.com to actual servers. 


It has a maintained blacklist of DNS servers 

that are for advertising and intercepts any such 
requests. To do this, Pi-hole must be your DNS 
server. Here things get complicated. For best 
results, your new Pi-hole server should also 

be your network DHCP server (the server that 
allocates IP addresses to your local devices). This 
requires some additional setup and we recommend 
you have a read of The MagPi #104 (magpi.cc/104). 


Careful with those ports 

A final warning. In this tutorial we’ve 
talked about opening ports to the internet using 
your router’s port forwarding features. You may 
be tempted to just directly open ports to the 
various services we’ve installed so you can get 
access wherever you are. One tip: don’t. The 
reason that services such as Wireguard exist is 
to ensure that bad actors can’t find any easy way 
to access your stuff. Wireguard uses state-of- 
the-art encryption. So long as your config file 
is not compromised, you’re more than likely 
completely safe. If you open your web server 
to the planet, we guarantee you will have bots 
sniffing around trying to find access within 
minutes. VPN isn’t easy, but it’s worth the time. 


Next time 

Well, we’ve built a pretty impressive 
server. File sharing, media streaming, 
remote access, network protection, and home 
automation. Next month we will look at how 
to protect all this hard work, and your precious 
data, from unexpected loss. Wl 
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WV Pi-hole is a network- 
wide ad blocker 
that's effective and 
easy to use 
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ow can we make our own computer 
with Python? Don't computers need 
lots of physical things like circuit 
boards and electronics? Normally 
yes, they do, but we're going to 
create something known as a ‘virtual machine’ - a 
computer defined completely by software, not 
hardware. You've probably used virtual machines 
many times without realising it. Many modern 
games consoles run older, classic games via 
virtual machines, also known as emulators. 

There are many kinds of emulator, but one 
of the most fun to start with is the CHIP-8. The 
CHIP-8 was never a real computer, but that's 
what makes it fascinating: long before most other 
games systems, it existed as a program for 8-bit 
computers in the 1970s. This means there's no 
hardware to attempt to emulate and quite a 


How to write your own 
emulator in Python 


Ever wanted to create your own computer? Here's how to do 
just that — and even get It to run some classic games 


A software engineer at video game developer Mediatonic, Edwin Jones 
has been working in the games industry for around 16 years. Find out 


simple specification to implement. The CHIP-8 
only has 35 opcodes, which is low compared 

to other computers. You still have all the usual 
problems to solve - loading binary files, parsing 
opcodes, and then running them on virtual 
hardware - but not the other baggage that comes 
with trying to write emulators for other systems. 
You also get to finish the project by playing some 
classic games - what's not to like? 

We'll be using Python 3 and Pygame for the 
project because CHIP-8 isn't very demanding 
and can be easily emulated. This means it’s a 
good fit for Python, as we don't need to worry 
So much about performance and can use a 
language that makes solving the problems at 
hand a bit easier - we don't need to focus as 
much on smaller details. 

A simple way to build such a device in code 
is with a class representing the CPU, so let's go 
ahead and create a Cpu class. Create a folder 


Name called pychip8 on your machine and save our 

i cae code below there with the file name cpu.py. We'll 
main be using this folder for every module we create. 
@ cpu , 

>. "this module defines the chip 8 cpu" 

@ font 


a keyboard_input 

é operation_code 

a operation_mapping 
é operations 


@ renderer 


class Cpu: 
"""this class represents the CHIP 8 cpu""" 


# game ram begins at address 0x200 / 512 
PROGRAM_START_ADDRESS = @x200 


> All being well, your pychip8& 
folder should look like this 
when you're finished. 


@ rom_loader # the chip 8 works with 16 bit/2 byte opcodes 


WORD_SIZE_IN_BYTES = 2 
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# V[15/@xF] is used as a carry/no borrow flag 
for certain ops 

ARITHMETIC_FLAG_REGISTER_ADDRESS = QxF 

FRAME_BUFFER_WIDTH = 64 

FRAME_BUFFER_HEIGHT = 32 


def __init__(self): 
# 4k of RAM 
self.ram = [0] * 4096 
self .program_counter = self .PROGRAM_START. 
ADDRESS 


self .index_register = 0 
self .general_purpose_registers = [@] * 16 


self .delay_timer = 0 


self .stack = [] 
self .stack_pointer = Q 


self .keys = set() 


self .frame_buffer = [[bool()] * 32 for i 
in range(64) ] 


self ._load_font() 


self ._current_word = 0 
self ._current_operation = None 


Can you see how we've defined the registers 

and buffers from the system's specification into 
simple Python types and collections? Don't worry 
about understanding all this code right now, as 
we'll be plugging in more parts of the computer 
as we go. This is just the ‘heart’ of the machine 
and where our core logic will run. 

The CHIP-8, like almost all computers, works 
by following a sequence 
of instructions. We're 
going to load up files 
representing these 
instructions in a binary 
format (called ROMs) and 
process each instruction one by one in our CPU. 
The name for such an instruction is sometimes 
known as - you guessed it - an opcode! 

The problem we face now is how can we get 
the data from a file into memory so our code can 
work with it? We can do this with a simple ‘ROM 
loader’ module that reads all the binary into a list 


“There are many emulators, 
but one of the most fun 
to start with is CHIP-8” 





for us to use later. You can see how this works in 
the code below - save this into your folder with 
the file name rom_loader. py. 


import os 


def get_rom_bytes(rom_name): 

"""This method loads the bytes from a rom from 
the roms folder""" 

folder = os.path.dirname(os. path. realpath(__ 
file__)) 

rom_folder = os.path.join(folder, "roms") 

rom_file_path = os.path. join(rom_folder, 
rom_name) 


with open(rom_file_path, "rb") as file: 
file_bytes = file.read() 
return file_bytes 


Here we're opening and reading the file in binary 
mode with the "rb" options string from the given 
file path and returning it from the get_rom_bytes 
method as a bytes object. This means we can 
then iterate over each byte in turn to decode 
each instruction for the CHIP-8. 

How can we parse the raw binary from a file 
and turn that into instructions for the CPU? The 
CHIP-8 has a strange 
opcode definition, in 
that each opcode is a 
16 bit / 2 byte value that 
contains the instruction 
and the data for that 
instruction. This would be simple enough were it 
not for the fact that apart from the first four bits, 
each following nibble can be part of an instruction 
or data - depending on the instruction in 
question. For instance, the opcode OxOOEO means 
‘clear the screen’, but opcode 0x1234 means 
‘jump to memory address 0x234’. A nibble might 
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A There are all kinds of simple 
games available for CHIP-8, 
from puzzlers to dinky 
Space Invaders clones. You'll 
find a good selection at 
wfmag.cc/chip-roms. 
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Wireframe 


This tutorial first appeared 
in Wireframe, our sister 
magazine that lifts the 

lid on the world of video 
games. Every issue includes 
tutorials and in-depth 
interviews, along with news 
and reviews of the latest 
indie and triple-A games. 


To find out more, visit their 
website at wfmag.cc. 


Check out their 
subscription offers at 
wfmag.cc/subscribe. 


a 
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This module defines methods that define the different operations the CHIP-8 
CPU could perform. 


import random 


import font 


# V[15] is used as a carry/no borrow flag for certain ops 
CARRY_FLAG ADDRESS = ®xF 


def add_to x(opcode, cpu): 
cpu.general_ purpose registers[opcode.x] += opcode.nn 
cpu.general purpose registers[opcode.x] &= @xFF # restrict the value to one 


byte or less 


def add_x_to_i(opcode, cpu): 
cpu.clear_arithmetic_flag() 
original value = cpu.index_register 
result = cpu.index_register + cpu.general_ purpose registers[opcode.x] 


result &= OxFFFF # restrict the value to two bytes or less 


A Be sure to get the 
full CHIP-8 code from 


wfmag.cc/wfmags4, sound strange, but it’s just half a byte. A byte is 
where you'll find the a 
operations.py module, 8 bits and can be represented with two hex digits, 
and more detailed 

Ce eee SO OxFF means 255. A nibble can be represented 
couldn't fit in here. with one hex digit (e.g. OxF for 15). This will come 


in handy later when we're manipulating our 
opcode data. One way 


self .word = word & QxFFFF 


# we just want the most significant bits/ 
nibble 

# here so we bitshift right 

self.a = (word & OxFQQQ) >> 12 


self .nnn = word & QxQFFF 
self .nn = word & QxQQFF 
self.n = word & OxQQQF 


# Where don't use the lower nibbles, 
bitshift 

# right to get just the raw value 

self .x = (word & QxQFQQ) >> 8 


# Eg. we want 0x4 not 0x40 
self.y = (word & QxQQFQ) >> 4 


Don't worry if you don’t understand all this 
code at once. The important thing to know is 
that we're parsing a 16-bit value and storing it 
in different fields of the class. opcode.a is the 
leftmost nibble, x the 


to solve this problem is “Don’t worry if you next one along, y the 


to abstract it into a class, 
which is exactly what 


don’t understand all 


one after that, and n 
the very last. You can 


we're going to do. this code at once” remember this with the 


Our next piece of 
Python code is going to be an Opcode class, as 
shown below. Again, save this into your folder, 
this time with the file name operation_code.py. 


class Opcode: 
"""This class represents the instructions and 


data of an opcode 


def __init__(self, word): 
This class takes in a 2 byte value/word 
and parses the bytes 
to store them in different attributes for 
later use 


Args: 


word: a 2 byte/16 bit value that 
represents an opcode. 


# We use bitwise AND with a mask to 
extract specific nibbles. 


# a word should be no more than 16 bits 


66 | magpicc | How to write your own emulator in Python 


hex-like pattern OxAXYN. 
opcode.word, opcode.nn, and opcode.nnn are ways 
of accessing these nibbles in groups. This will 
come in handy later on. 

Now we have a way to read the ROM and parse 
the contents of it, but what can we actually do 
with all this data? The CHIP-8 has 35 opcodes, 
but we shall only be using 33 of them. For 
simplicity, we're ignoring sound and any machine 
code operations. You can find a list of them on 
Wikipedia at wfmag.cc/opcode. 

First, let's define a module that turns 
these opcodes into readable functions we 
can reference. Hex is fun, but it’s not easy to 
understand what the raw numbers mean at 
times. The following bit of code is too long to 
run in full here, but you'll find it on our GitHub 
at wfmag.cc/wfmag54. It's the file named 
operations.py - here's a small snippet: 


def add_to_x(opcode, cpu): 
pass 


def add_x_to_i(opcode, cpu): 
pass 


def add_y_to_x(opcode, cpu): 


pass 


Don't worry that all these functions contain a pass 


Statement at the moment; the important thing is 


that each one has the same signature and a clear 


name. Now we need to make another module, 
called operation_mapping.py, that lets Us map 
the raw binary/opcode to one of the functions 
we've defined above. Modelling code without 

a full implementation like this is often known 

as stubbing, and can be a useful approach to 
working on a problem when you aren't entirely 
sure what the solution will be, but do need to 
have some idea of the interface you'll be using to 


solve it. 


from operation_code import Opcode 


import operations 


def find_operation(word): 
opcode = Opcode(word) 


if word == OxQQEQ: 
return operations 


if word == QxQQEE: 


return operations. 


if opcode.a == Qx1: 


return operations. 


if opcode.a == Qx2: 
return operations 


if opcode.a == Qx3: 


return operations. 


if opcode.a == Qx4: 


return operations. 


if opcode.a == Qx5: 


return operations. 


if opcode.a == Qx6: 


return operations. 


if opcode.a == Qx7: 
return operations 


if opcode.a == Qx8: 


.clear_display 


return_from_function 


goto 


.call_function 


skip_if_equal 


skip_if_not_equal 


skip_if_x_y_equal 


set_x 


.add_to_x 


if opcode.n == 0x0: 


Ge Command Prompt 


Microsoft Windows [Version 10.0.19042.1110] 


(c) Microsoft Corporation. All rights reserved. 


s\ryanl>cd documents 
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-s\ryanl\Documents>python pychip8 --rom="bc_test.ch8" 


2.0.1 (SDL 2.0.14, Python 3.9.5) 
» from the pygame community. https:// 


return operations. set_x_to_y 
if opcode.n == Qx1: 

return operations. bitwise_or 
if opcode.n == Qx2: 

return operations.bitwise_and 
if opcode.n == Qx3: 

return operations.bitwise_xor 
if opcode.n == 0x4: 

return operations. add_y_to_x 
if opcode.n == Qx5: 

return operations. take_y_from_x 
if opcode.n == Qx6: 

return operations. shift_x_right 
if opcode.n == Qx7: 

return operations. take_x_from_y 
if opcode.n == QxE: 

return operations. shift_x_left 


if opcode.a == Qx9: 
return operations. skip_if_x_y_not_equal 


if opcode.a == QxA: 
return operations. set_i 


if opcode.a == QxB: 
return operations. goto_plus 


if opcode.a == QxC: 
return operations. generate_random 


if opcode.a == QxD: 
return operations.draw_sprite 


if opcode.a == QxE: 
if opcode.nn == Qx9E: 
return operations. skip_if_key_pressed 
if opcode.nn == QxA1: 
return operations. skip_if_key_not_pressed 


if opcode.a == OxF: 


www. pygame.org/contribute. html 


‘s\ryanl\Documents>python pychip8 --rom="Tank.ch8" 






A Once it’s complete, you can 
run CHIP-8 straight from 
your command line, like this. 





TECH SPECS 


The CHIP-8 has the following 

specifications: 

e 4kB of memory 

e 16 general-purpose 8-bit 
registers (the 16th is 
also used as a special 
arithmetic flag at times) 

e A 64 pixel-wide by 32 pixel- 
high frame buffer 


e A stack that stores return 
addresses for function 
calls and nothing else 


e Some way to store 
the pressed state of a 
16-button keypad (0-F) 


e An 8-bit index register 

e An 8-bit program counter 

e An 8-bit stack pointer 

e An 8-bit delay timer register 


e An 8-bit sound timer 
register (when above zero, 
a beep is made) 
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v Yes, it’s a bit blocky, but 
it’s a tiny, functioning 
version of Space Invaders. 
Pretty neat. 





if opcode.nn == QxQ7: 

return operations.set_x_to_delay_timer 
if opcode.nn == QxQA: 

return operations.wait_for_key_press 
if opcode.nn == Qx15: 

return operations.set_delay_timer 
if opcode.nn == 0x18: 

return operations.set_sound_timer 
if opcode.nn == Qx1E: 

return operations.add_x_to_i 
if opcode.nn == Qx29: 

return operations. load_character_ 


address 
if opcode.nn == Qx33: 
return operations. save_x_as_bcd 
if opcode.nn == Q@x55: 
return operations. save_registers_zero_ 
to_x 
if opcode.nn == Qx65: 
return operations. load_registers_zero_ 
to_x 


raise KeyError(f"Opcode {word:#06x} not 
present in list of valid operations") 


Now we're cooking! This code will take a block of 
16 bits we load from a ROM file, parse this into 
Our Custom Opcode class and use the properties 
of that class to figure out what corresponding 
functionality the opcode is referencing. If you 
refer to the table from wfmag.cc/opcode, you 
should be able to see exactly what our functions 
are going to actually do by looking up the 
related opcode. 

Before we can wire this up further, we're going 
to need to add some extra functionality. There 
are a few opcodes that handle drawing to the 
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screen, loading fonts, and input handling, so we 
need to define code that can manage this logic 
for us. Let's start with the internal font of the 
machine. The CHIP-8 has a single font that is 
hard-coded into memory, and usually stored in 
the first 512 bytes of memory (Ox000-0x200). The 
font is basically a pattern of bits that describes 
the dots that make up each letter. Let’s make a 
module with this pattern as shown below, and 
Save it as font.py. 


Chars are 4x5. Each line must be a byte wide so 
each line value is padded with 0x0. 


Eg: 
Q: 
#AHHEE = =#+1111 = FO 
= 1001 = 90 
= 1001 = 90 
= 1001 = 90 


HHHE «= «©1111 = FO 


# each char is 5 bytes long, so to get 

# char 'B' you'd use DATALCHAR_SIZE_IN_BYTES x* 
QxB ] 

CHAR_SIZE_IN_BYTES = 5 


DATA = [QxFQ, 0x90, 0x90, Qx90, OxFO, # 
Q@x20, Ox60, Ox20, Ox20, Ox70, # 
QxFQO, Qx10, OxFO, Ox80, OxFO, # 
QxFQ@, Q@x10, OxFQ, Ox10, OxFO, # 
Qx90, Ox90, OxFO, Ox10, 0x10, # 
OxFQ, @x80, OxFO, Ox10, OxFO, # 
QxFQ, @x80, OxFO, 0x90, OxFO, # 
QxF@, @x10, @x20, Ox40, 0x40, # 
QxFO, @x90, OxFO, Q@x90, OxFO, # 
QxFQ@, @x90, OxFO, 0x10, OxFO, # 
OxFQ@, @x90, OxFO, Ox90, Ox90, # 
QxE@, @x90, OxEQ, Ox90, OxEO, # 
QxFO, @x80, 0x80, Ox80, OxFO, # 
Q@xEQ, @x90, 0x90, Ox90, OxEO, # 
QxFO, @x80, OxFO, Ox80, OxFO, # 
QxFO, @x80, OxFO, Ox80, 0x80] # 


“nNnvoUvoindwoarwooaonandtt FF WN = OD 


The code above is a layout of a series of nibbles 
in a list format that we can access, and each 

5 bytes represents the raw pixels of a character. 
Each “1” equals a lit pixel for each character; each 
character is 4 bits across and consists of 5 rows. 
As we only use a nibble, only the most significant 
bits of each byte are used - that is why each 
value ends with 0. 
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Next, we're going to need some way to handle 
input. The CHIP-8 had a very simple input 
mechanism — 16 keys from 0-F. This fits exactly 
into a nibble. Let's define a module to map our 
keyboard keys to those values. Save the following 
as keyboard_input.py: 


"""This module contains the keyboard input 


handling logic 


import sys 


import pygame 





“@ CHIP-8 Noughts and 
Crosses. Perfect if you 
don’t have a pen and 
piece of paper handy. 


if event.key in keys: 


keys = {} cpu. key_up(keys[event.key]) 
keys[pygame.K_0] = Qx@ 

keys[pygame.K_1] = Qx1 This code defines a dictionary to map keyboard 
keys[pygame.K_2] = Qx2 input into and a function we can use to check 
keys[pygame.K_3] = Qx3 which keys are pressed. We then pass that data 
keys[pygame.K_4] = Qx4 into our CPU. Handy! 

keys[pygame.K_5] = @x5 The last missing part of our emulator is the 
keys[pygame.K_6] = Qx6 renderer. Arenderer is simply some code that 
keys[pygame.K_7] = Qx7 can take raw data and instructions and turn 
keys[pygame.K_8] = 0x8 those into some form of visible output. We'll use 
keys[pygame.K_9] = Qx9 Pygame Zero to draw to our screen and we can 
keys[pygame.K_a] = QxA define our renderer like so, remembering that 
keys[pygame.K_b] = @xB the CHIP-8 was limited to a 64x32 resolution with 
keys[pygame.K_c] = @xC black and white output. The following needs to be 
keysL[pygame.K_d] = @xD saved with the file name renderer.py: 
keys[pygame.K_e] = QxE 

keys[pygame.K_f] = OxF """This module defines the renderer object and 


def handle_input(cpu=None): 
This function handles control input for this 
program. 


for event in pygame.event.get(): 


# quit if user presses exit or closes the 
window 
if event.type == pygame.QUIT: 
sys.exit() 


# check cpu registers and inject key input 
if cpu: 
if event.type == pygame.KEYDOWN: 
if event.key == pygame.K_ESCAPE: 
sys.exit() 


if event.key in keys: 
cpu. key_down(keysLevent. key ]) 


if event.type == pygame.KEYUP: 


related methods""" 


import pygame 


WHITE = pygame.Color(255, 255, 255) 
BLACK = pygame.Color(@, 0, Q) 
SCALE = 10 


# The CHIP-8 display ran at only 64 * 32 pixels. 
# this value scales the framebuffer 

# so it's easier to view the emulator on modern 
displays 

screen = pygame.display.set_mode((640, 320)) 


def render(frame_buffer ): 


"""This method draws everything to the screen 
screen. fil1(BLACK) 
for x in range(64): 


for y in range(32): 
if frame_bufferLx]Ly]: 
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A Figure 1: If the bc_test.ch8 
ROM shows this message, 
then congratulations: you 
have a functioning CHIP-8 
emulator, and you're ready 
to play some games! 


B Or 





sLLode r. 


pygame .draw. rect( 
screen, 
WHITE, 
(x * SCALE, y * SCALE, SCALE, 
SCALE) ) 


# Go ahead and update the screen with what 
we've drawn. 


# This MUST happen after all the other drawing 


commands. 


pygame .display .update() 


The code above takes the frame buffer of the CPU 


and iterates through it, drawing a 10x10 white 


Square for every pixel that should be set. This gives 


us a larger window to see the emulator running, 
and will be easier to use on a larger, modern 
display. A frame buffer is just a section of memory 
that stores things you want to show on a display 
monitor or TV. In our case, it’s just a 2D list of 
Boolean values representing ‘on’ or ‘off’ for a pixel 
that we defined in our Cpu class earlier. 

We're getting closer to having something 
work as all the core components of our system 
are now wired in. There's a bit more code we 
need to add to our CPU now we've defined all its 
dependencies. Let's go back and add some extra 
imports to the top of our CPU module, cpu.py: 


from operation_code import Opcode 
import operation_mapping 
import font 


Now append the code below to the end of the 
CPU module: 


def key_down(self, key): 
"This method sets a key as pressed" 
if key not in self .keys: 
self .keys.add(key) 


def key_up(self, key): 
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"This method sets a key as released" 
if key in self.keys: 
self .keys. remove(key ) 


def move_to_next_instruction(self): 
self .program_counter += Cpu.WORD_SIZE_IN_ 
BYTES 


def move_to_previous_instruction(self): 
self .program_counter -= Cpu.WORD_SIZE_IN_ 
BYTES 


def load_rom(self, rom_bytes): 
for i, byte_value in enumerate(rom_bytes): 
self .ram[Cpu.PROGRAM_START_ADDRESS + 
i] = byte_value 


def set_arithmetic_flag(self): 
self .general_purpose_registers[self. 
ARITHMETIC_FLAG_REGISTER_ADDRESS] = 1 


def clear_arithmetic_flag(self): 
self .general_purpose_registers[self . 
ARITHMETIC_FLAG_REGISTER_ADDRESS] = 0 


def emulate_cycle(self): 
self ._current_word = self .fetch_word() 


opcode = Opcode(self ._current_word) 
self ._current_operation = operation_ 
mapping. find_operation(self ._current_word) 


self .move_to_next_instruction() 
self ._current_operation(opcode, self) 


def fetch_word(self): 
word = self.ram[self.program_counter] << 8 
| self.ramCself.program_counter + 1] 


return word 


def update_timers(self): 
if self.delay_timer > Q: 
self .delay_timer -= 1 


def _load_font(self): 
offset = Qxd 
for item in font.DATA: 
self .ramLoffset] = item 
offset += 1 


If you read through the code above, you should 
be able to understand what each method is doing 


as there is acomment in each one to help you 
understand the code. We'll need this for the next 
step as we're going to revisit Our operation class 
and fill in the blanks we left earlier. This is going 
to be quite a lot of code - as before, it's too much 
to print here, so download the file operations.py 
from our GitHub at wfmag.cc/wfmag54. Don't 
worry too much about what each method does; 
focus more on what opcode it relates to and what 
functionality it achieves for our emulator. There 
are several comments to help you understand 
each opcode, if you're interested. 

We only need to write one more module to get 
our emulator working and to see our hard work 
pay off. We need an entry point to our code that 
initialises and runs it in the right order. Let's go 
ahead and create a file called _ main__.py (NB: 
there are two underscores either side of the 
word ‘main’) that will handle all this for us. 


"""This is the main entry point for the program 


import argparse 
import keyboard_input 
import renderer 
import rom_loader 
import pygame 


from cpu import Cpu 
if __name__ == "__main_": 


parser = argparse.ArgumentParser() 

parser.add_argument("-r", "--rom", 
required=True, type=str, help="the name of the rom 
to run in the emulator") 

args = parser.parse_args() 


cpu = Cpu() 

clock = pygame. time.Clock() 

rom_bytes = rom_loader.get_rom_bytes(args.rom) 
cpu. load_rom(rom_bytes) 


pygame.display.set_caption("pychip8" ) 
pygame. init() 


# main loop 
while True: 
keyboard_input.handle_input (cpu) 


# The CHIP-8 is reported to run best at 
around 500 hz 
# The update loop runs at 60 fps. 60 * 8 = 


480, which is close enough. 
for _ in range(8): 


cpu.emulate_cycle() 


cpu.update_timers() 
renderer ..render (cpu. frame_buffer ) 


# delay until next frame. 
clock. tick(60) 


The code above sets up all the dependencies, 
loads the ROM data, and runs the core loop of 
the CHIP-8 CPU, which will read and evaluate 
instruction by instruction. Don't worry about 
“cunning out”, as almost every ROM loops; they're 
not designed to terminate without user input. 

The last thing we'll need is a ROM to test this 
out with. First, let’s use a debug ROM - the best 
I've found is called bc_test created by BestCoder. 
Create a folder called roms in your working 
directory and copy bc_test.ch8 into it from this 
repository: wfmag.cc/chiptest. 

With the ROM in place, open the directory that 
contains your pychip8 folder in your terminal 
of choice and run the command python pychip8 
--rom="bce_test.ch8". You should see something 
like the output in Figure 1. If you do, have a round 
of applause - you have a working emulator! If you 
see nothing on the screen, the error’s likely in 
the renderer module; if you see a screen like the 
one in Figure 2, then you'll be able to work out 
what's gone wrong by checking the error codes at 
wfmag.cc/error-codes. 

Once you're sure the test passes, it’s time for 
real games! There are plenty of ROMs available 
for the CHIP-8 - you'll find several at wfmag.cc/ 
chip-roms. Just copy the files into your roms 
folder and run the commana, replacing the test 
ROM name with the name of the ROM you want 
to run, and bingo: you're playing games ona 
computer that you wrote yourself! 
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¢< Figure 2: If running the 
bc_test.ch8 ROM gets you a 
message like this, then you 
can troubleshoot your 
emulator with the error list 
at wfmag.cc/error-codes. 
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Operating 





Raspberry Pi 





Systems 


Whatever you want to do with Raspberry Pl, there's an 
Operating system for that, as Phil King finds out 


official Raspberry Pi OS is an excellent, 
easy-to-use operating system, but it’s not the 
only show in town. 

You might want to give an alternative general- 
purpose OS a go, such as the popular Ubuntu with its 
slick interface and large software catalogue, or the 
user-friendly and accessible Manjaro. If you’re feeling 
adventurous, there’s also RISC OS: an evolution of the 
Acorn Archimedes operating system dating back to 
1987, it’s super-fast and offers a fascinating insight 
into how desktop OSes used to look and work. 


BR ased on Debian, a flavour of Linux, the 
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Raspberry Pi opera 





Other Raspberry Pi operating systems are aimed 
at particular use cases. For media playback, there’s 
LibreELEC and OSMC: both based on Kodi, they 
offer a slick interface for navigating your music and 
video collections, as well as streaming media. Retro 
gaming fans are also well catered for with a choice 
of RetroPie, Recalbox, and Lakka for emulating old 
consoles and computers. Then there are specialist 
OSes such as OctoPi (3D printing) and Home 
Assistant (smart home). 

Trying out a new operating system is as easy as 
writing it to a microSD card with the Raspberry Pi 
IFunketex-ymnnore) Ma st<t:40) Recep vet-t:4-) OMmniel (elem er-Kwent-ben me) 
options already built-in, so why not give it a go? 











Ubuntu Desktop 
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Available: Raspberry Pi Imager, ubuntu.com/raspberry-pi 


Works on: Raspberry Pi 4 (4GB+), 400, CM4 (4GB+) 
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cost-effective PC alternative for years, 

but you don’t have to stick to the official 
Raspberry Pi OS: Ubuntu is a popular flavour of 
Linux used on millions of PCs around the world. 

While Ubuntu is also available in more 
lightweight Server and Core versions, the new 
Desktop edition is the fully-fledged version of the 
Linux distro. So if you’ve used it before, it’ll all be 
very familiar in how it looks and works. 

Available in the menu of the Raspberry Pi 
Imager tool (magpi.cc/imager), it’s a pretty large 
download and takes a little while to write to a 16GB 
or larger microSD card. Boot it up on Raspberry Pi 
and it starts with a system configuration welcome 
wizard where you can Set up the keyboard type, 
WiFi connection, and add a new user. It then takes 
a few minutes to configure everything. 

The GNOME desktop environment is 
aesthetically pleasing with an applications sidebar, 
launcher, and search facility. The downside is that 
it’s rather sluggish to use: there’s a slight delay 
whenever you open or do anything on the desktop. 
Not everything works out of the box, either: you 
may well get a message saying you need to install 
some extra packages to do something such as 
playing MP4 videos. 


p eople have been using Raspberry Pi asa 








One of the main advantages of Ubuntu is its 
huge software library. Pre-installed apps include 
the Firefox web browser, Thunderbird email client, 
Rhythmbox music player, and LibreOffice suite. 
More can be installed via the Ubuntu Software tool 
— or, alittle confusingly, also from the Snap Store, 
Synaptic Package Manger, or Terminal. You may 
well find more recent versions of some software 
than in Raspberry Pi OS, such as 
Python 3.8. The GPIO pins can 
be used by installing the LGPIO 
Python library. 

If you want to stay on the 
cutting edge, Ubuntu gets a major 
update twice a year, although 
this can sometimes cause issues 
with stability. 


Fully-fledged desktop OS 

ro} Nod ml aarere(=1game10]| a 

Large software catalogue 
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RISC OS Pt 


Type: General-purpose 
Available: Raspberry Pi Imager 
Works on: All models 
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developed by Acorn to run on its 32-bit 

ARM-based Archimedes home computer 
in 1987. Since Raspberry Pi also uses an ARM CPU, 
it seems only fitting that the OS is available for it. 
Meloyaabenlevevinvaeyim=s ehaalorse-himmeeyalmbole(cismKene(-\1(-(0)0 
RISC OS, including a special version tailored for 
Raspberry Pi 400 (available from riscosopen.org). 

The first thing you’ll notice when installing 
RISC OS is how compact it is. This is an ultra- 
lightweight OS that only requires a 2GB microSD 
card - there’s no advantage in using a larger one, 
since the OS can only use the first 2GB. Amazingly, 
it’1l also work on any Raspberry Pi model, even the 
original Model B from 2012. 

The old-school GUI is a world away from 
Raspberry Pi OS or Ubuntu. It looks very retro and 
applications are grouped together in folders rather 
than in a main menu. The other aspect you’ll notice 
is that it runs like lightning, even though it only 
operates on a single core of the CPU. 

An intriguing aspect is that it’s based around 
using a three-button mouse: the left button is select, 
middle (or scroll wheel) displays a contextual menu, 
while right is ‘adjust’ (a modified version of select). 


Ni ow this one takes us back. RISC OS was first 


Raspberry Pi operating systems 


Once you get the hang of it, this can prove very 
effective. If you only have a two-button mouse, you 
can always assign a keyboard key as the third button. 

Bundled software includes the primitive NetSurf 
web browser, PipeDream office suite, and a selection 
of basic games (called ‘diversions’). Using the 
StrongEd text editor, it’s possible to program in 
languages such as BBC BASIC, Lua, and Python. 
Extra software can be installed using the !Store and 
PackMan package managers. 

The biggest downside is that Raspberry Pi’s 
on-board wireless LAN is not yet supported, so 
you’ll need to use a wired Ethernet connection ora 
special WiFi HAT to get online. In addition, the GPIO 
pins on more recent Raspberry Pi 4 models aren’t 
recognised, while the USB 3.0 ports only work at USB 
2.0 speeds. 

Still, it’s well worth a look for the nostalgic and 
the curious and could prove useful for learning how 
computers work under the bonnet. 


Ultra-lightweight OS 
Extremely fast to use 
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Manjaro ARM Linux 


Type: General-purpose 
7ANVE-\ | F=\ 0) (=o ot 1-J 0) ol- 1g eV a a atele (=m aatclaltclgene) ae] 
Works on: Raspberry Pi 3, 4, 400, CM3/3+/4 
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anjaro aims to be a simpler, more 
Vi user-friendly version of Arch Linux while 
providing all the benefits of cutting-edge 
software — it boasts its own large repository 
alongside the Arch User Repository. 

You can install Manjaro with one of four 
desktops - KDE Plasma, GNOME, Xfce, MATE - or 
the lightweight Sway window tiling manager, ora 
minimal version with no desktop. 


Kali Linux 


> Type: Security testin 
¥etcr=Yo Rola Veet a Mialtyre yp y g 


al fe Lal hvmede tine) aaltctale) (=) > Available: kali.org 
LeTofole Mei ale) (x= me) me(=s-] que) os 


Large software repository > Works on: All models 


> Minimum card size: 16GB 


a 
a / bh (ec E a E C ali is a specialist distro for information security tasks such as 
K veetcation testing. Once installed on Raspberry Pi, you can use 
it to audit the security of other devices on your network. 
There’s no configuration wizard, so you’|l need to set up a few 


Available: Raspberry Pi Imager, libreelec.tv things manually. You do get a desktop (Xfce), though, and a set of 
built-in security apps, plus the Firefox web browser. 


Type: Media centre 


Works on: All models 
* Specialist security distro 

* Good range of OS versions 

° Set of built-in testing tools 

* Some manual configuration needed 
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ased around the 
B Kodi media player 
software, LibreELEC 
is a lightweight single- 
purpose distro that’s 
simple to set up and use. The menu system is 
Slick and easy to navigate, with sections including 
movies, TV shows, and music. You can also stream 
media by installing add-ons for services such 
as YouTube, BBC iPlayer, and Disney+. Witha 
Raspberry TV HAT attached, you can even use it asa 
personal video recorder. 
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= eee ling 
a 


+o al Pe =a i; ee 





Ser ee eg ed el eG, a rey 
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Slick, easy-to-use interface 

Supports most media files 

lke lalnymedetcixe)aalict-le)(-Mudidel-e(etrelal 
Watch and record live TV (with TV HAT) 
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OSMC 


_ Type: Media centre 
_ Available: Raspberry Pi Imager, osmc.tv 
~ Works on: All models 
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is a fully-fledged OS, enabling you to install 

other applications. So it may prove more 
versatile if you need to also use your Raspberry Pi 
for anything else, such as a web server. 

When using it for Kodi media playback, OSMC 
works very similarly to LibreELEC with an easy- 
to-use menu system to navigate media categories 
such as movies, TV, and music. 


BR ased around the Kodi media player, OSMC 


Me seller iK-rele(-veMe)el-1e-ltlale Nico) 08 
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_ Versatile and customisable 


Raspberry P1 OS versions 


With Desktop (32-bit): 
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RetroPie 


_ Type: Retro gaming 





_ Available: Raspberry Pi Imager, retropie.org.uk 
~ Works on: All models 
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brings together a suite of emulators for 
over 50 retro consoles and computers. 
Running it on a Raspberry Pi 4 or 400 gives you 
the most power, enabling better emulation 
of later systems such as the PlayStation 2, 
GameCube, and even the Wii. 
Use it in a standard setup with a monitor or, for 
a more authentic experience, a bartop or full-size 
arcade system. 


3 uilt on top of Raspberry Pi OS, RetroPie 


- Emulates over 50 systems 

a (Co) g <olalr-\imaarvore (=) 0 

_ Customisable menus and settings 
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Lakka 


Type: Retro gaming 
P\VE\ Ele) LOCH AY 
Works on: All models 
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akka is another solid option for retro 

gaming. Each game is implemented as 

a libretro ‘core’, while RetroArch takes 
care of the inputs and display. So, while it 
doesn’t support quite so many systems as its 
rivals, it offers a single, unified, and consistent 
configuration for all its emulators. Controllers 
typically work as soon as you plug them in, too. 


Versions for all models 
Download from website 
Painless configuration 
Samba sharing for ROMs 








Recalbox 


ecalbox offers a wide range wide of 
emulators for retro gaming — if not 
quite so many as RetroPie. It does 


come with the Kodi media player built-in, 
though, so it’s ideal if you’re look for an all- 
in-one entertainment system. 

Recalbox also adds a share partition on 
the microSD card so you can easily remove 
it from Raspberry Pi to add game ROMs on 
another computer. 
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MotionEyeOS 


Type: Security camera 
P\VE-1| lo) K=wmaata\e] o) Reve save) d(elat-\Vi-ve)— 
Works on: All models 
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his OS turns your Raspberry Pi into a 

video surveillance system using a Camera 

WU Woye hey Cemcbovey key mh) pier. benl-a- bam Golemer-bement(-) a) 
set up a network to cover different rooms of your 
home, monitoring all the camera feeds in a web 
interface. It can be set to capture photos and video 
whenever motion is detected on a camera, and 
send you email/push alerts. 





CCTV security system 
Options for multiple cameras 
Orla aalolalixe) @-{-\V(=1¢-\mcele) sal) 
Download from website 


> Type: Retro gaming 
> Available: Raspberry Pi Imager, recalbox.com 
> Works on: All models 


> Minimum card size: 8GB 
* Versions for every model 
* Wide range of emulators 


* Kodi media player built-in 
¢ Share partition for ROMs 
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info-beamer 
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Wayne's Widgets 
Available: Raspberry Pi Imager, info-beamer.com 


Normal opening hours, Jam - 6pm Mon-Sat 


Works on: Raspberry Pi 2, 3, 4, Zero W, CM3/3+/4 The shop will be closed on Eank Holiday Monday 
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found in shops, restaurants, cinemas, = 
museums, etc. To create your own, all SLO cee Rtas 
you need is a Raspberry Pi with info-streamer 
installed and a monitor or TV. 
Sign up for a free account and you can monitor 
and control your device(s) from a web dashboard. 
With multiple screens and Raspberry Pi boards, 


a 
you can even set up a video wall. fits S i st G ‘aye 
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D igital signage installations are typically 





Available: Raspberry Pi Imager, home-assistant.io 
Works on: Raspberry Pi 3, 4, 400 
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ia 
OctoP! 
H ome Assistant is an open-source 


i+ ecosystem for smart home automation and 
boasts a helpful worldwide community of 
enthusiasts. Easy to set up and use, it features 
eae ‘Integrations’ (plug-in modules) to support over 
>» Works on: Raspberry Pi 3, 4, 400, CM3/3+/4 1,000 smart devices; you can even program your 
ee. luke tt own in Python. Little wonder PJ Evans opted to 
use it for his tutorial series on home automation 
Starting in The MagPi issue 99 (magpi.cc/99). 


> Type: 3D printing 


> Available: Raspberry Pi Imager, octoprint.org 


> Minimum card size: 8GB 


controlling a 3D printer remotely from a web browser. It adds LO NV(=1 am IneL elo Me (=\Vi(ex-\-¥-10 |e) ele] ai-re| 

WiFi to any 3D printer with Yo) o) al i-id (ors ik=re MN (=) eMel= "1a ]eles-\cel 
a USB port, for easy file dropping sn 2 Powerful automations 
and remote control via a web i | = 3 Le Tofole | K= Ko) mw Ni => Cc Miol(x-merolal age). 
dashboard. You can also adda 
camera to the setup for a live video 
stream of the 3D printing process, 
and to record time-lapse videos. 


0 ctoPi contains the OctoPrint software for monitoring and 





Control a 3D printer 
Access via web interface 
Live camera stream 
CuraEngine slicing 
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FEATURE Maghi 


Homebridge 


Type: Smart home 


“Your Homebridge setup 
can be controlled via a 
web-based interface” 


A\VE-\ | F=1 0) (= ot- J 0] ol- 1a eV a Late le (lem alelgalqvela (ele (ae) 
Works on: All models 


Mi iTaliaalelaamers\ge@ci74- HAC] =} 


pple’s HomeKit is great for controlling 
your smart home, but it’s not compatible 
with all devices. Homebridge offers a 
Raspberry Pi-based solution, enabling you to 
integrate other devices such as Nest thermostats, 
Ring video doorbells, Philips Hue light-bulbs, and 
Sonos speakers. 
Your Homebridge setup can be controlled 
via a web-based interface, including 
installing or removing plug-ins — there are 
Over 2,000 available. ™ 


(Hirrabeedhoe: 


Q rem @ tre mm 


bier inter 


3.81GB 35GB 


60°C 12m 


Goda FH ie rege Fae [Sy 
ener bar ch 
OH a |) Ha 


aT 


Use other devices with Homekit 
ONV{=) a-Mololon ol leve Bi lal= 
Web-based interface 

Wo) (ox=Moxolaidcel Mud italia 


Other OSes 





We didn't have space in this feature to cover every available operating system for Raspberry Pi. 
Here are a few others to consider... 


PNW oyiat=m mlalehacclieliat-1ilaley @elce) Mamie) alay((-1(e]a1m Os) 
with an emphasis on security. 


ALT (altlinux.org): Russian language OS, 
available in Raspberry Pi Imager under ‘Other 
language-specific OS: 


PV cola W Miah @N i mcclccsallialehclasake)ce)MmlelaiAdolelall 
and flexible OS, the basis of Manjaro. 


CentOS (centos.org): Robust Linux distro, 
fefe)elulc-laxe)mavlalaliae Pic OBs\o acl icy 


Ol al coyaaTeleame RM iaarcle] olReovAcialcolaalielaate-) Hm mate) 
open-source basis for Chrome OS, as used in 
(@ialcolaat= elele) ccs 


DietPi (dietpi.com): Extremely lightweight 
Debian-based OS with a simple interface. 


emteria.OS (emteria.com): Full build of 
PN aXe|col(e hella alsremKe)\/-lce (om ale IS iav mules 


Fedora ARM (arm.fedoraproject.org): ARM 
version of Fedora Linux, only works on 
Raspberry Pi 2 and 3. 


la c=1=) sh] PRQag-1=] o}-(e Ke) cep MOI NIV Gail Come) Ol=igeli| ale 
system, an alternative to Linux. 


FydeOS (fydeos.io): Customised version of 
Chromium OS for Raspberry Pi 4 and 400. 


© f=} a) Kolon (o[=1al KeloNe) ge) Mimi(elaiNmollsike)aalist=lo)(=) 
Linux distro, not easy to install. 


Lubuntu (lubuntu.net): Lightweight Linux OS 
based on Debian, with minimal LXDE desktop. 


NetBSD (netbsd.org): Fast and secure UNIX- 
like OS based on BSD. 


jel. @Co) c=) ad F=\WWiz1 md e)(exe) g=10) t= \V(-1 ae) ge Mad ilali gale Ops) 
(o(=rJ[e[aloro molmc~anlelkcmaalllsi(ome)t-\ver-\e1.¢ 


Pi MusicBox (pimusicbox.com): Stream music 
or play locally stored tracks and podcasts. 


Slackware ARM (sarpi.penthux.net): 
Slackware is one of the oldest Linux distros. 


SliTaz (slitaz.org): Compact OS that works 
forolaale)icixci\valam ans aaleavmiceaankelanelakeealqe| 
USB stick. 


00D CoM dalial tiar eorelan) Hy amnsallamell(clalmmre\\Zoll tolo)l=) 
as a 30-day trialin Raspberry Pi Imager, it's a 
compact OS that's useful for kiosk displays. 


V(o)(o Mal eh a@avol(ellialeyaeolcepmilare(=1e\-ialelcials 
general-purpose Linux distro. 
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ME MagPi | REVIEW 


Hiwonder TonyP1 





DIMENSIONS: 
186 x 113 x 
373mm; 1.7kg 


COMPONENTS: 
Raspberry Pi 4 
4GB, 11V battery, 
3MP camera 
(480x800 pixel) 
14 x LX-824HV 
servos, on-board 
lithium-ion 
battery pack with 
DC charging point 
(US adapter), 
power level 
indicator 


ACCESSORIES: 
3 x Tag cards, 3 x 
colour balls, servo 
wire, screwdriver 


> With 14 servos, TonyPi 


is both powerful and 
responsive to 
user commands 


> Hiwonder » hiwonder.hk P»& £380/S519 


Raspberry Pi 4-powered humanoid robot with built-in smarts 
and options to set up bespoke behaviours. By Rosie Hattersley 


with plenty of personality to keep you 
engaged as you learn fun ways to interact 
with him. He can either be controlled via an iOS 
or Android app, or you can use a Raspberry Pi, 
Windows PC, or Mac. 
Containing a Raspberry Pi 4, TonyPi comes 
preassembled (aside from the connectable head), 


T onyPi is a 37cm-tall humanoid robot 
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so the fun here is all about controlling him. He’s 
a solidly built fella, with angular joints and broad 
lower arms and hands primed for scooping up 
coloured balls on command. We rather liked his 
all-white finish, which contrasts with his 14 
deliberately visible LX-824HV servos. Agility- 
wise, TonyPi can walk, shimmy, wave, bow, get 
up, and turn his head — all from the smartphone 
or tablet app, while more advanced controls 

can be added as custom list items via Python 
and OpencV. 


MWe tried to fool him with 
posters of people and 
various charming but 
inanimate objects, but 
TonyPi was unmoved @ 


Swiping a finger in the window section of the 
Hiwonder app moves TonyPi’s head. You’1l need 
to swipe several times to get TonyPi to move 
much, though. Body movements can be initiated 
using the step controls at the top of the on- 
screen control panel, or by tapping within the 
circular control area. The upper control section 
causes TonyPi to step forwards and backwards 
and turn gently to one side, while the circular 
control section sees him jump peremptorily 
whichever way he’s instructed. 





Clear vision 

TonyPi’s object recognition ability is great. One 
neat trick is his ability to recognise faces, waving 
in response. We tried to fool him with posters 

of people and various charming but inanimate 
objects, but TonyPi was unmoved. 

‘Colour tracking’ was also impressive: select 
a colour and move the corresponding ball gently 
in front of his 3-megapixel camera and TonyPi’s 
head will follow the ball’s movements. He will 
also nod when shown an object that’s red, green, 
or blue - our orangey-red sofa was an easy win — 
but he doesn’t always get it right. 

Line following was largely successful: TonyPi 
strode along confidently on straight stretches, 
slowing but still following the line round gentle 
bends. It’s best to set his head to point down so 
he is able to follow the trail; if not, he may veer 
off unexpectedly at an angle. Three QR codes are 
included in the box: place these against a light 
background and TonyPi will wave, shimmy, or 
shuffle his feet. You can also create your own QR 


codes and have your robot do something else, 
having programmed a different action in Python 
using the instructions provided. 

Be aware that switching user modes causes 
TonyPi to revert to his initial position, as we 
inadvertently discovered. If TonyPi is lying 
down, you’re likely to have one heck of a shock 
when you switch him back on and tap the ‘get 
up’ instruction on the Hiwonder app. TonyPi 
launched himself backwards as he automatically 
tried to stand upright from the prone position 
we’d left him in. Luckily, your reviewer caught 
him just as he was about to disappear off the 
edge of the kitchen table. 

Instructional PDFs really help in getting 
the most from using TonyPi, but using a PC or 
Raspberry Pi as a control via SSH and a smartphone 
hotspot is extremely fiddly, more than pi-top’s 
Robotic Kit with its built-in IP address-displaying 
OLED [magpi.cc/108]. Once set up, though, 
possibilities such as adding a microphone and 
trying voice recognition come into play. Hl 


REVIEW | Maghi i 


<< TonyPiis a great- 
looking robot that can 
be easily controlled via 
Android or iOS apps 





Verdict 





TonyPi is an 
impressively 
designed robot 
with solid object 
recognition 
features. For 
longer-term 
entertainment, be 
prepared to log in 
remotely and 

use Python to 
access his more 
advanced features. 


8 0 
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MagPi 


10 Amazing: 


A look back at some of Mike Cook's 
best Builds in The MagP| 


ou may have read last month that Mike 

Cook, legendary tech writer and author of 

our monthly Pi Bakery since issue 33, has 
decided to retire from regular tutorials in The MagPi. 
While we’ ll see him again in the future, we wanted 
to highlight ten very cool things that he made over 
nearly 80 issues. Thank you, Mike! 





A fun holiday game to make and play, where you take the reins of 
Santa's sleigh to deliver The MagPi magazines to kids everywhere. 
Unfortunately, the real Santa is too expensive to use monthly. 
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This project tests your fidget-spinning skills to see just how fast you can get out 
of the maze determined by how fast you spin. 





Perfect for the spooky season, these 
scary skeletons can be made to 
deviously dance by your own hands, 
while classical music is played 

of course. 


Use a tablet to control this wonderful, 
old-school storytelling method that 
will be sure to impress and entertain 
many kids, young and old. 





This guitar uses a mixture of Raspberry Pi Pico and Trill touch sensors to create 
a very customisable MIDI guitar. We love the case for it as well. 





MagPi 


Wooden train sets are irresistible. You have to play with them. 
Linking them up to an e-book allows you to turn pages using the 
train, a great way to keep kids engaged with reading. 





Meet Head and Ron, glowing spooky creatures that are used as part of the 
Collider game, where you try and match the lights at the right moment. 





Mees 
* 

| 5 Ft 

4 


Use various knobs and dials to change your voice using this 
Raspberry Pi Pico project in a very cool box. 





Using some rotary encoders, you can interact with an oscilloscope to create 
weird and wonderful noises, for fun and scary movies. 





This cool little instrument is one of 
many that Mike has made, with sides 
you can tap for sound. This two-part 
tutorial starts in issue 90. 


Mike is also the author of Raspberry Pi Projects for 
Dummies, which you can grab at magpi.cc/mikecook. 
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Learn circuit design 


with Raspberry P1 


Discover how to design your own electronic 
Circuits with these resources, By Phil King 





Getting Started 
in Electronics 


Who better to teach you the 
fundamentals of electronic 
circuits than Forrest M Mims, 


Forrest M Mims 





Aes on the designer of the original 
aad Altair 8800 home computer? 
magpi.cc/ 


Billed as a complete electronics 
course in 128 pages, this classic 
tome is all the more remarkable 
for its handwritten text and 
hand-drawn diagrams! While 
there are more in-depth 
electronics books around, this 
one will certainly give youa 
solid grounding. 


electronicsmims 


Oevbbal-Mexelbbacy-t 





Starting with the basics of 
electricity, it takes youona 
tour of digital and analogue 
components and how they work. 


It moves on to integrated circuits 


and digital logic gates using 
switches and transformers. 
Linear circuits are also 
covered; responding to a wide 
range of voltages, they have 
many applications. 

Of most interest to us is the 
section on using electronic 
components to make temporary 





Study circuit design with these 
interactive courses 
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CRASH COURSE 
ELECTRONICS & PCB DESIGN 
This Udemy course is aimed 

at those learning electronics 
from the ground up who wish to 
leverage that knowledge to build 
actual PCBs. 

> magpi.cc/crashcoursepcb 


TINKERING FUNDAMENTALS: 
CIRCUITS 

Participation is essential in 
Coursera's hands-on workshop 





(i.e. ona breadboard) and 
permanent circuits. There are 
100 tried and tested circuit 
designs to explore, arranged 
into categories such as basic, 
photonic, digital, and linear. Hl 


as students are encouraged to 

try things out, ask questions, 

and share ideas with each other as 
a community. 

> magpi.cc/tinkeringcircuits 


ADVANCED DIPLOMA IN 
BASIC ELECTRONICS 

This free Alison course covers the 
principles of electronics and some 
of the theorems guiding the design 
of electrical circuits. 

> magpi.cc/alisonelectronics 





An Introduction 
to Electronics 


This OpenLearn course is 

an adapted extract from the 
Price: Open University course T212 
Free Electronics: sensing, logic and 
actuation. Just sign up for a free 
account to enrol. Taking around 


Open University 





magpi.cc/ 
openlearnelectronics 


Free course Free statement 
An introduction to electronics [E] oreantcnaon 


on completion 









HackSpace 
Magazine #48 


The ultimate achievement 
in circuit design is to create 
your own printed circuit board 
(PCB), but it may seem a 
daunting prospect. The latest 
issue of our sibling magazine, 
HackSpace, demystifies the 
process with a 12-page feature 
showing you how to get started. 
As the article explains, “If 
you can build electronics on 
a breadboard, you can design 
a PCB. There’s no magical 
difference. Instead of wires, you 
just have traces of copper.” 
Using the EasyEDA online 
software (easyeda.com/editor), 


Ben Everard 





Price: 
£6 / $8 (or free PDF) 


hsmag.cc/issue48 
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ten hours at your own pace, it 
starts with the basic theory of 
electrical circuits, including 
Ohm7’s law, Kirschoff’s laws, and 
series and parallel circuits. 

It then goes on to cover some 
fundamental circuits — including 
voltage dividers, the Wheatstone 
bridge, operational amplifiers, 
and sensors — before exploring 
the concept of signal processing 
using sounds. 

Each section features videos 
and/or interactive elements, By 
the end of the course, you should 
be able to use basic components 
to design simple electronic 
circuits, as well as having learnt 
a lot more about the general 
concepts involved. 


|S feore):¢= 


to read 


Check out these 
info-packed books 





MéigPt 


ELECTRONICS 


cpioZERO | 


=: feapborry Fi 





SIMPLE ELECTRONICS 
WITH GPIO ZERO 

Build breadboard-based 
electronic circuits connected 
to Raspberry Pi and control 
them with Python programs 
and the easy-to-use GPIO 
Zero library. 

> magpi.cc/gpioessentials 


anage | 


MAKE: ELECTRONICS 


A great primer for general 


= 


electronics, it’s full of 
interesting facts and runs 
you through 36 ‘experiments’ 
building circuits using 
standard components. 

> magpi.cc/ 
makeelectronics 


eam Fr 
sewn 


ELECTRONIC CIRCUIT 
DESIGN IDEAS 


Aimed at the more advanced 


it takes you through all the steps 
of designing a PCB to work with 
a Raspberry Pi Pico. Starting 
with a schematic, various 
components are added, along 
with custom artwork and copper 
traces for connections. Finally, 
you can send your board design 
off to be manufactured. Hl 


user, this weighty compendium 
covers over 170 circuit types 
and explains them in great 
detail with diagrams. 

> magpi.cc/ 
circuitdesignideas 
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Vv This optical drive 
would take care 
of Akkie’s hamster 
while he was away 
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Can you be ag maker without knowing electronics? 
Akkie was before Raspberry Pl 


> Name AkiraOuchi | » Occupation Infrastructure engineer 
> Community role Maker | » Website github.com/Akkiesoft 


44@ had no electronic skills sticking apenintoanold mouse  by[moving] the tray of the 
at all before I learned to create a sort of tablet, or optical drive,” Akkie tells 
and started playing with making use of an optical disc us. “It is quieter, easier, and 
Raspberry Pi.” drive to look after his hamster. smarter to implement similar 
Not the kind of thing you’d “Although the term ‘IoT’ functions with a Raspberry Pi, 
expect to hear from one of the was not common in 2009, | server monitor, and infrared 
best-known members of Japan’s combined the optical drive, LED nowadays.” 
wonderful maker community, cardboard, and springs to create 
Akira Ouchi, or Akkie as he’s a thing that could feed the When did you learn about 
best known. He had been doing hamster or control the power Raspberry Pi: 
little projects though, like switch of the air conditioner I discovered Raspberry Pi on 


the RS Components’ website 

on 12 March 2012 — I found this 
from my Twitter [Ed, see photo]. 
At that time I used a Linux 
netbook for my optical drive loT 
project to demonstrate at some 
events. I thought Raspberry 

Pi could make it compact the 
demo stuff. After replacing the 
netbook with Raspberry Pi, | 
created a wearable optical drive 
attached on the top of a helmet, 
and Raspberry Pi built-in 
optical drive. 


What are your favourite 
things that you’ve made with 
Raspberry Pi: 

My fave is a Plarail (japanese 
train toy for kids) project 

that can be controlled from a 
smartphone. A Raspberry Pi 
Zero and camera are mounted 
to the carriage, [along with 


M | think it's amazing the sense of unity 
q community can feel when they get 
their hands ona junk part @ 


a] built-in motor driver and 
LiPo battery. 

I enjoyed using the motor 
driver to control acceleration 
and deceleration, and the design 
of the web UI. 


What differences have you 
noticed in the Japanese maker 
community compared to 

the USA/UK? 

I don’t know much about 
overseas maker communities (or 
Japanese communities even), 
but when I saw maker events in 
US or the UK, I found there were 
more huge (literally!) projects 
than in Japan. It might be hard 
for us to create huge projects in 
Japan because, in many cases, 
there is not enough space in our 
house to work in. 





~ This train set is controlled by 
Raspberry Pi Zero and a smart 
phone. There's a Camera Module 
stuck to the front as well 


Furthermore, Japan has its 
own certification system for 
power supplies and radio waves, 
and it often takes a long time 
for foreign products to become 
available in Japan. Sometimes 
they cannot be used in Japan 
because the manufacturer often 
does not obtain certification 
in Japan. Compared to the 
certification system in US or 
UK, I assume it makes things 
less flexible for Japanese 
makers’ projects which use 
radio waves... 

Apart from our country’s 
system, I think it’s amazing the 
sense of unity acommunity can 
feel when they get their hands 
on a junk part. In early 2021, it 
was very popular for Japanese 
makers on Twitter to take out 
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A Akkie's first 
Raspberry Pi, as 
posted to his Twitter 
account in 2012 


a 64048 pixel LCD that was 
built into a children’s toy and 
analyse it. No matter if they 
knew each other or not, makers 
brought information they had to 
Twitter and GitHub, and made 
controlling the LCD possible 

in a few weeks. That was really 
amazing. It is available for 
Raspberry Pi as well. I followed 
those instructions, bought the 
toy, and made it work too. Hl 


Translation 
by Satoka Fujita 


See Akkie’s work 


“[Over the last year], there has 
been no online event for Open 
Source Conference ( OSC: 
ospn.jp). | usually exhibit and 
introduce Raspberry Pi projects, 
and give a presentation as 
Japanese Raspberry Pi Users 
Group at the OSC’'s events. | 
also showed projects at Japan's 
Maker Faire events. 

“| post about projects and 
[the] making process on my 
blog (magpi.cc/akkieblog) and 
Mastodon (magpi.cc/akkie).” 
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MagP1 


Amazing projects direct from our Twitter! 


very Monday we ask the question: have you 
made something with a Raspberry Pi over 
the weekend? Every Monday, our followers 
send us amazing photos and videos of the things 
they’ve made. 
Here’s a selection of some of the awesome things 
we got sent this month - and remember to follow 
along at the hashtag #MagPiMonday!! 





01. Pet-cam number one this month, with a 
cute dog to keep track of 


02. Auseful range sensor! And a clever way to 
solve a voltage problem 


03. Chickens count as pets, right? A great use of 
a simple automated Raspberry Pi project 


04. Pet-cam the third, with a small cat napping 
in the corner and tweeting in private 


05. Litter collection of the future maybe? 


06. This would not look out of place on the 
robot that Sly is cutting from Rocky IV 


07. Thisisavery cool upcycling project. Be 
careful working with a big computer 
PSU, though! 


08. Robot mower updates are always fun - this 
one keeps getting better 


09. Agreat start to Halloween decorations from 
early October 


10. This is avery impressive synth idea brought 
to life! 


11. Using some clever code, CycOb has 
managed to create virtual bumpers so that 
this robot knows when it has hit an obstacle 
by how much power the motor is using 
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Monday 





Surrogate 
@SurrogatelV 


Replying to @TheMagPi 


A Raspberry Pi doggie cam to check on the dog and 
give her snacks at a press of a button. ye 





Frank 
, @Frank76139220 





Replying to @TheMagPi 


Managed to combine the ultrasonic distance sensor 
with the LCD through my Pico. Had to use a voltage 
divider as my HC-SRO4 is neither + nor P. 


a vrriarryr 


Cédric de |'Epine 
iS pideriared_ 


Naranju 
@yuud) 


Replying to @TheMagPi 


ot 


Replying to @TheMagPi 


My chicks doorman :) 
IR cam and gate control (open / close the coop via cron 
and web) 


pr ivarse tweeter account. 















Thatimplituhedran 
EThémplltuhbedron 





Replying to @Thetlagr 


Based on ‘@Raspberry_Pi 4, | designed this 
autonomous (lidar) litter detection robot employing an 
®Edgelmpulse object detection model to recognize 
and classify litter. It also deploys a video stream and a 
fall detection system. 





Brian Gortell © 
af SCannonFodder 


Rephyaing to aThe Magri 





| made a matrix flash LEDs randomly with a @pimoroani 
Plasma RP2040 LED controller board for my 4PiVWars 
Doofus robot In the style of a 50s / 606 movie 
computer. #iagPiMonday = “7 


Replying to Gi iveMest 


No Halloween edition, but the upcoming Mode! Ui 
the PiMowBot will have a tilt compensated compass 
based on a 9-axis IMU MPU-9250-module and a more 
powerful motor driver. | just finished the software 
tweaks for this over the weekend. 


#RaspberryPi #Robotics #Lawnmower 





Repting to Gitettas 


Got my CD-ROM plotter working! Thanks to 
@homotfaciens! Still needs some tweaking... 





Replying to @TheMapghi 


Nothing for Halloween, but this is looking like it is 
to have it's scary moments... 


diyelectromusic.wordpress.com/2021/10/08/bar... 


a #MagPiMonday 


Chains irenusec word press.coen 


“Bare Metal” Raspbeny Pi Synih 








MagPi 


Python + MQTT + TweePy : Pet cam. Send commads 
via MQTT,takes picture or animate gif. Post itin a 






Stewart Watkiss 


@stewartwatkiss 
Replying to @TheMaeP 


Raspberry Pi pixel-server to control RGB LEDs / 
NeoPixels using a web browser. 
Also works with smartphone and home automation. 


youtu.be/s5SEvig_ VRdE 


It will be used for lighting up my driveway at Halloween, 
but remember: a Raspbery Pi is for life, not just for 


Halloween ‘* 


y yOutvTuDEe,.cOm 

Raspberry Pi Wireless NeoPixel server for RGB LEDs 

Run a wiréless NeoPixel / Pixelstrip server on a Raspberry P) 
Usina Pyitvon, Flask and WS281x library turns a Raspberry ... 








GoPiGo3_Stalled_Wheels.mov 


Ore EI pet 
A Vimeo Feature 
bw Oo go oO <q wore 
MagP!i Monday magpi.cc 
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Best of 
the rest! m & 


Amazing projects that we were Spay = ° ‘ = 
contacted about this month 


a] 


PIHUNTER 


> magpi.cc/pihunter ~ 
an ro 

We got an email from Gabriel Simches, a cyber 

security analyst, about his Raspberry Pi threat- 


Sa LM Ce Mier Fawn! Faw BR Berens Pies Powe! 


hunting device, which he has excellently called 
piHunter. He reckons it will work athomeandin Here are the tools it runs: 
a “small to mid-sized office” as well. 

“Set up a Raspberry Pi to collect full-packet 
captures on your network, then index, normalise, 
and search through your data to find anomalies,” 


Cabrales ow Ci ub. “All thadate-snd tools Filebeat Winlogbeats (TBD) | RITA Run-RITA-Run | tcpdump 
activity is ready to go! A good threat-hunting Past pigs atin Nee oan 
device has both GUI tools and multiple Living off SoverShelll 

the Land (LotL) tools.” 


INTERACTIVE BOOKSHELF 


> magpi.cc/iotlibrary 


“The Internet of Things landscape is riddled 
with commercial companies that want to gather 
as much data as they can, while I think a library 
thrives on privacy,” writes Willem Jan in his blog 
about his interactive bookshelf idea. Using a series 
of sensors and LEDs, Willem thinks he can make 
finding and discovering books more fun. 

The blog goes into his research on sensors, 
microcontrollers, and microcomputers, before 
giving a practical build for your bookshelf. 

“Although this blog is very technical, I will try to 
inform a general audience about the possibilities 
that the Internet of Things has to offer.” 


= 
= 
= 
% 
= 
= 
ie 
= 
a 
= 
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TERMINATOR HUD 


> magpi.cc/termhud 


Ever wanted to see like the Terminator? Maybe not 
but it’s a cool idea for a video filter that looks great 
as well. It’s all written in Python for Raspberry Pi 
Camera Modules, and works best on Raspberry Pi 4 
as it needs a bit of oomph to get it working. 





TRACKING PLANES IN BRAZIL 


> magpi.cc/coffeeradiopod 


We got an email from Martin Butera who hosts a podcast 
in Brazil’s capital, Brasilia, about radio and coffee. While 
talking to Thiago Pereira Machado, he mentioned how he 
used Raspberry Pi to track aircraft, acool and common 
project for English speakers but not one we’ve seen in 
Portuguese before. 








V/, 


Crowdfund this! 22242202 YY 






< ’ : 


Mini Pupper Little Hackers 


A cute quadrapedal robot based on Raspberrry Pi, it's 





perfect for learning about robotics with it's incredible 12 Learning to code with less screen time was something 
degrees-of-freedom and open source software including Google Engineer Brandon Tory was worried about, so he 
the Robot Operating System, OpenCV for computer created a book to allow you to do just that with help from 
vision, and SLAM for mapping its surroundings. his six-year-old son 

» kck.st/3zVVaZA >» kek.st/3zOfvQr 
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Raspberry Pi Zero 2 
is here, and we 
gave one to all 
current subscribers. 
Get yours with a 
new subscription 





Subscriber gifts 


I was wondering if you were still doing a Raspberry Pi Zero with your 
subscriptions? Do subscribers get anything else as well with their 
subscription? I’ve been meaning to get one for ages. 


Christof vic Twitter 


As you may have noticed by now, the subscription offer has been 
upgraded to include a Raspberry Pi Zero 2. You can find more info 
about that on page 32. As for gifts, current subscribers also received a 
Zero 2 in the post. Subscribing is the best way to make sure you get 
any of the special items we give away! 


A lot of people love to share what 
they're working on via Twitter 


If I have a Raspberry Pi project 
I’d like you to see, where is the 
best place to send it? 

I think it would be a great fit 
for The MagPi. 


Daisy vid email 


We’re more than happy to look at 
any Raspberry Pi, Raspberry Pi 
Pico, or RP2040 projects that you 
may have done, and emailing is 
the best way to show us. 
Otherwise, contacting us on 
Facebook, or showing us on 
#MagPiMonday on Twitter isa 
good start! Sometimes, if we see 
it online, we’ll also contact you 
about it. Whether it becomes a 
project showcase, a mention in 
This Month in Raspberry Pi, or a 
retweet, we love to see and share 
what you’re making! 


MagPi 





Make sure to check 


out our spooky project 
upgrades feature in 
. . . : . issue 110 for some last- 
Will you be showing off Halloween projects again this year from the minute ideas 


community? I’ve got some really fun plans and I was wondering 
whether I should send them to you! I hope you like being scared... 


Phil via Facebook 


We absolutely will if you share it with us! Due to the peculiarities of 
creating a magazine, this November issue will come out a few days 
before Halloween, and the issue after Halloween has happened will be 
the December issue — which will have Christmas stuff in it. Don’t 
worry, though: we’ll print them any time of the year. 

Speaking of which, don’t forget to send us your Christmas projects 
too! Although they’ probably end up in the February issue. 


Twitter 
Facebook 
Email 
Online 
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IN VIDEO GAMES 
Turnn-based tactics 


from the makers 
of Northgard 


Recreate Valve's 2: 
leanie teleporting 


mechanic in Unreal 


fis ing, food, <a friendship: the inside story 
of 2021’s most we RPG 
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WAVESHARE 


E-INKDISPLAY PHATS 


WITH 20 HEATSINKS FOR RUNNERS-UP! 


IN ASSOCIATION 
WITH THE PI HUT 






WL: 








This 2.13" E-Ink display Is perfect 
for the Raspberry Pi Zero 2 \W 
that you can get free with your 
twelve-month subscription to 
The MagPi. We have five to give 
away, and 20 runner-up prizes 
of a heatsink for Zero 2 as well. 





Head here to enter: magpi.cc/win | Learn more: magpi.cc/einkdisplayphat 





Terms & Conditions 


Competition opens on 27 October 2021 and closes on 26 November 2021. Prize is offered to participants worldwide aged 13 or over, except employees of the Raspberry Pi Foundation, 
the prize supplier, their families, or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering the competition, the winner consents to any 
publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine. We don't like spam: participants’ details 
will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. Winners will be contacted by email to arrange 
delivery. Any winners who have not responded 60 days after the initial email is sent will have their prize revoked. This promotion is in no way sponsored, endorsed or administered by, 
or associated with, Instagram or Facebook. 
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QuickStart guide to setting up 
your Raspberry Pi computer 


Updated with Raspberry Pi Pico 
and all the latest kit 


The very best projects built by 
your Raspberry Pi community 


Discover incredible kit and 
tutorials for your projects 
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Tapping into tech 


Intriguing early encounters with computing led to 
Rosie Hattersley’s career writing about them 


of computers when my visiting 

aunt reached into her bag and 
triumphantly produced lengths of stiff 
cardboard with seemingly random 
bits punched out. Whereas my mum 
had been one of the earliest female 
students of cybernetics, her sister 
had gone into teaching maths. Both 
were perfectly placed to encounter 
programming 1970s-style, and my 
mum spent two happy years as a 
Fortran programmer. 

School meant Casio watches and 
LED displays; sometimes built into 
pleasingly flexible, twangable rulers; 
sometimes embedded into the shaft of 
a pen. Resetting the time and date was 
the ideal excuse to linger ina 
classroom while chatting to (aka 
flirting with) nerdy, but nice, 
schoolmates. Almost without fail, an 
overlooked friend would interject with 
a rude word spelled out on their fancy 
scientific calculator screen. 

The arrival of two BBC Micros in the 
school library caused a stir. Asa 
wannabe journalist, I became the 
editor of the newspaper we put 
together as aclass. Getting to use one 
at school meant taking business and 


first encountered the concept 
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information studies so I could get at 
the Acorn computers in the commerce 
suite. Unfortunately, I had to spend 
the first half-term learning to touch- 
type — anathema for an impatient and 
less than dextrous teenager. 


Commodore coding 
Thankfully, a brilliant Commodore 64 
made it into our home. I spent hours 
learning to play a musical keyboard 


M The arrival of two 
BBC Micros in the 
school library 
caused a stir @ 


which sat above the computer’s own 
keyboard, and typing in game code 
from books. I taught myself BASIC and 
set up modest databases to organise 
my growing record collection, but was 
often ousted from the C64 by my 
games-hunery brother, keen to thrash 
another joystick in the service of Daley 
Thompson’s Decathlon. 

Our Dad spent an apocryphal £3000 
on a Elonex 386 laptop, heavier even 


than the Smith Corona typewriter 
with the three-page text memory that 
I would write my university essays on. 

My first computer was a second- 
hand Mac, so! could brush up the 
QuarkXpress and Photoshop skills I 
used in my first job in publishing, 
indirectly taking me to a writing role 
at home computing title PC Advisor 
where I got to try out, review, and 
write about using hundreds of 
eadgets, games, apps and programs 
and, eventually, learn about an 
intriguing product known as 
Raspberry Pi and its aim to put 
computers and computing skills in the 
reach of the world. The global success 
of maker faires, Raspberry Jams, Pi 
Wars, Code Clubs and dojos, as well as 
the dozens of individual projects that 
I’ve been lucky enough to learn about 
first hand and write about for The 
MagPi, show that Raspberry Pi has 
brilliantly delivered. Hl 


Rosie Hattersley 





Rosie Hattersley has been writing about 
the joy of tech for the past two decades 
and (occasionally) still misses QuarkXxXpress. 


@RosieHattersley 


Tools Window He 


, MoverDemo 
~ ml MoverDemoApp Untitled 
> g CDP 
mg GPIOServer 
mw ADS111510Server 
gw Controller 


Em MoverDemoLib 


» MoverDemoApp 
» CDPProperty 
» CDPMessage 
» CDPSignal<double> 
Process Timer 


Issues Alarms Search R... Applicatio... Compile ... General ... Connecti... 
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Home projects made easy. 














CDP Studio, a great software development tool for your home projects. Build 
SSVESI 1 a ahS¥n Ae) fl a -]s) ©) Ol=1 8 AVA od RO IS1- Mk Ora am) OM NO] Oxo lo(>m 0) cele] e-lanlanliale pre) Ol-1amcvole| qexoml le) e-] a (-1ce 
(o]U) axe) in al=mm ole) @rs10] 0) ole) aan ce) am] =] O Mm VAGrE\Y/ LO) Im im @) = Om OW) ale anle)q-Mm@1a-y-1(-mOl-t-1ULGIAO|MUIi-18 
interfaces. Built for industrial control system development, FREE for home projects. 


cdpstudio.com 
Tel: +47 990 80 900 « info@cdptech.com 
CDP Technologies AS // Hundsvzergata 8, 6008 Alesund, Norway 
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GHPI PRO 


-——— The new case from the HIPI.iIo team —————-- 
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® Rapid tool-free assembly and disassembly ® Secure microSD card cover 

® Large internal volume for HATs @ VESA mount support 

® Compatible with Pi 2/3/4 ® Molding-configurable output ports 
e Multiple lid options customizable for volume orders 

® Passive & Active Cooling options @ Printed logo for your branding 


Available at these great Pi stores: 


4 ew bad hy 
@=PiShop.us (PiShop.ca {*fPiShop.mx €zPiHut PrSHop.ch Welectron. 






Contact your favorite Pi store if it’s not listed here 


